Kubuntu 26.04 Setup Notes

Posted on Edited on

Kubuntu 26.04 配置紀錄 (Kubuntu 26.04 Setup Notes)

本文將簡單記錄一些在 Kubuntu 26.04 上遇到的問題與解法。

藍牙鍵盤無法配對 (Bluetooth Keyboard Cannot Pair)

若系統無法成功配對藍牙鍵盤，通常是因為藍牙控制器的模式設定不正確。

Reference: Ubuntu 20.04 cannot pair Bluetooth Keyboard

解決步驟 (Solution Steps)

首先，檢查 /etc/bluetooth/main.conf 中的 ControllerMode 設定：

1
2
# Search for the ControllerMode configuration
grep "ControllerMode" /etc/bluetooth/main.conf

請根據搜尋結果進行以下調整：

  1. 若值不是 dual：請將其修改為 dual。
  2. 若值為 dual 但行首有 #：請刪除 # 以取消註解。

完成修改後，重啟藍牙服務或電腦，系統應能正常搜尋到鍵盤。

鍵盤 Fn 鍵功能異常 (Adjusting Function Key Behavior)

許多第三方鍵盤在 Linux 下會被識別為 Apple 佈局，導致 Fn 鍵預設觸發的是多媒體鍵（如音量、亮度），而非 F1-F12。這可以透過調整核心模組 hid_apple 的參數來修復。

如果你的鍵盤是 Keychron 或其他有提供 Windows/Mac 實體切換開關的鍵盤，建議先確認開關是否切換到正確的系統檔位。在 Linux 上，通常切換到 Windows 檔位搭配 fnmode=0 能獲得最接近標準鍵盤的體驗。

臨時測試 (Runtime Testing)

你可以先在不重啟的情況下測試哪種模式符合需求。請注意，不同的模式會決定「直接按下按鍵」與「組合 Fn 鍵」後的行為：

1
2
3
4
5
6
7
8
9
10
11
# Mode 0: Disable hid_apple functionality
#         停用 hid_apple 特殊處理 (按鍵行為回歸硬體預設)
echo 0 | sudo tee /sys/module/hid_apple/parameters/fnmode

# Mode 1: Media keys as default (standard behavior)
#         預設為多媒體鍵 (需配合 Fn 才能觸發 F1-F12)
echo 1 | sudo tee /sys/module/hid_apple/parameters/fnmode

# Mode 2: F1-F12 as default (recommended for developers)
#         預設為 F1-F12 (需配合 Fn 才能觸發多媒體鍵，工程師常用)
echo 2 | sudo tee /sys/module/hid_apple/parameters/fnmode

永久生效 (Make Changes Persistent)

確認測試成功後，建立設定檔以確保開機自動套用。例如，若你決定使用 Mode 0，請執行以下指令：

1
2
3
4
5
6
# Create the configuration file for the hid_apple module
# Make sure the value matches the mode you tested above
echo "options hid_apple fnmode=0" | sudo tee /etc/modprobe.d/hid_apple.conf

# Update initramfs to ensure the settings are applied during early boot
sudo update-initramfs -u

Winboat 應用程式中文輸入異常 (Chinese Input Issue in Winboat)

Reference. https://github.com/TibixDev/winboat/issues/245#issuecomment-3861976728

Potential fix for KB Layout

(Version: v0.9.0)
This fix won’t work if you need multiple layouts to be available to you.
I managed to fix keyboard layout not changing by editing registry keys, but after testing a little more I’m not sure how this works because I reset the values back to what they were before my change then restarted the VM and the issue didn’t reappear, so there’s probably more to it than I’m realizing. Either way, these are the steps I took:

  1. In Windows settings, go to Time & Language > Typing > Advanced Keyboard Settings and set your keyboard layout there (you’ve probably already done this)
  2. Open the registry editor and go to HKEY_CURRENT_USER\Keyboard Layout\Preload, then delete all entries except for the one labeled “1”
  3. Go to HKEY_USERS\.DEFAULT\Keyboard Layout\Preload and change the value of entry 1 to be the same as the one for your current user (from the last step)
  4. Stop and restart the Windows VM (you can do this in WinBoat > Home)

After those steps it started working for me. Again, I’m not sure how much of this is required for it to work or if this will even work for others. Hopefully this helps anyone else facing this same issue