如何在 Linux 上使用 RazerGenie 設定 Razer 設備

RazerGenie 是一款開源的 Linux 應用程序，用於配置支援的 Razer 週邊設備。它可以調節 RGB 燈光和亮度，對於相容的滑鼠，還可以調節 DPI 檔位和輪詢率。它依賴OpenRazer，因此必須先在主機上安裝驅動程式和守護程序，RazerGenie（尤其是其 Flatpak 版本）才能偵測到裝置。

OpenRazer 支援的裝置頁面，包含鍵盤和滑鼠類別。 — 安裝驅動程式前，請先查看 OpenRazer 的支援設備清單。

1. 檢查支援並安裝 OpenRazer

請在OpenRazer 官方設備清單中找到您的特定型號。穩定版和開發版的支援可能有所不同，因此僅在開發分支中列出的型號可能需要更新的軟體包。如果您的版本未在下方列出，請使用最新的安裝指南。

OpenRazer 使用 DKMS 建構核心模組。如果您的軟體套件管理器沒有新增與您正在執行的核心相符的頭文件，請自行安裝；Ubuntu 和 Debian 通常會自動拉取這些頭文件。

Ubuntu、Linux Mint、elementary OS、Pop!_OS 和 Zorin OS

對於最新的穩定版本，請新增 OpenRazer PPA 並安裝其元軟體包。在 elementary OS 系統上，如果需要，請先安裝 PPA 助理。

sudo apt install software-properties-gtk
sudo add-apt-repository ppa:openrazer/stable
sudo apt update
sudo apt install openrazer-meta

此輔助命令主要用於 elementary OS；僅在需要時才在其他作業系統上執行。

使用 Ubuntu 終端指令新增 OpenRazer 穩定版 PPA 並安裝 openrazer-meta。 — 穩定的 PPA 提供 RazerGenie 使用的 OpenRazer 軟體包。

Fedora 和 Nobara 41 或更高版本

對於 Fedora 41 及更高版本，請安裝匹配的核心開發包，添加 OpenRazer 軟體倉庫，並安裝驅動程式：

sudo dnf install kernel-devel
sudo dnf config-manager addrepo --from-repofile=https://openrazer.github.io/hardware:razer.repo
sudo dnf install openrazer-meta

較早的 Fedora 版本使用不同的倉庫語法；請查看最新指南。

Fedora 終端機顯示了 kernel-devel、OpenRazer 軟體倉庫和 openrazer-meta 安裝指令。 — Fedora 使用者應按照其所使用版本的倉庫說明進行操作。

Arch Linux

安裝 OpenRazer 以及與您的核心版本相符的頭檔：

sudo pacman -S openrazer-daemon
sudo pacman -S linux-headers

適用linux-headers於標準 Arch 核心；對於其他核心版本，請安裝其對應的頭檔套件。守護程式包依賴 OpenRazer 驅動程式包。有關當前軟體包的詳細信息，請參閱官方 Arch 軟體包列表。

使用 Arch Linux 終端機安裝 openrazer-daemon 軟體套件。 — Arch 透過其官方軟體倉庫打包了 OpenRazer。

對於 Debian 系統，請先使用官方軟體包搜尋；較新的設備可能需要OpenSUSE 建置服務 (OBS)。 OBS 頁面也涵蓋了 openSUSE 的相關內容。請避免使用過時的特定版本軟體倉庫指令。

2. 設定權限並重啟

OpenRazer 需要您的使用者帳戶屬於有權存取裝置文件的群組。在大多數發行版中，請使用plugdev：

sudo gpasswd -a $USER plugdev

在基於 Arch 的發行版上，OpenRazer 目前的故障排除指南建議改用openrazer組：

sudo gpasswd -a $USER openrazer

安裝驅動程式並變更群組成員資格後，請重新啟動，以便重新載入核心模組和權限。

Linux 終端機將目前使用者新增至 plugdev 群組。 — 大多數發行版使用plugdev；基於Arch的系統使用openrazer群組。

如果驅動程式無法載入，請檢查核心頭檔和 DKMS 建置。安全啟動可能會阻止未簽署的模組；在更改韌體設定之前，請參閱官方故障排除指南。

3. 安裝 RazerGenie

Flatpak 可在各種發行版上運行。如果 Flathub 未配置，請新增遠端伺服器並安裝 RazerGenie：

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub xyz.z3ntu.razergenie

出現提示時確認安裝。 Flathub的產品資訊指出，OpenRazer 必須安裝在 Flatpak 之外。專案自述文件列出了原生軟體包選項。

Linux 終端機添加 Flathub 並安裝 xyz.z3ntu.razergenie Flatpak。 — 只有在主機系統上安裝了 OpenRazer 之後，才能安裝 GUI。

4. 設定您的 Razer 設備

重新啟動後，從應用程式選單開啟 RazerGenie，然後在左側邊欄選擇裝置。具體控制方式取決於設備型號和 OpenRazer 支援情況。

在裝置側邊欄中選擇支援的黑寡婦鍵盤，即可使用 RazerGenie。 — 選擇要設定的鍵盤、滑鼠或其他支援的裝置。

更改燈光效果和亮度

在「照明」設定中，選擇一種可用的效果（例如靜態、呼吸、光譜循環、波浪或動態），並設定顏色（如有提供）。不同設備的效果可能有所不同。

RazerGenie 的燈光頁面，效果下拉式選單已展開，並選擇了光譜循環。 — 選擇設備支援的燈光效果之一。

使用亮度滑桿可以調暗或調亮燈光。如果可用，請開啟「自訂燈光編輯器」為按鍵或區域指派顏色；支援的控制會因型號而異。

RazerGenie 燈光控制介面顯示了一個效果選擇器和一個亮度滑桿，亮度滑桿設定為 70%。 — 亮度調整獨立於所選照明效果。

RazerGenie 的自訂燈光編輯器顯示了單鍵 RGB 顏色的鍵盤。 — 當硬體支援時，可以使用自訂編輯器為每個按鍵或每個區域設定燈光。

調整滑鼠DPI

對於相容的滑鼠，請開啟DPI設定並編輯靈敏度檔位。某些裝置會提供單獨的 X 和 Y 值，或提供將它們關聯起來的控制項。圖中所示的數值僅為範例；檔位和最大 DPI 取決於滑鼠型號。

RazerGenie 的滑鼠 DPI 頁面具有多個靈敏度等級以及單獨的 X 和 Y 值。 — 僅設定滑鼠支援的DPI檔位和數值。

更改輪詢率

開啟“輪詢率”設定並選擇可用值。常用選項包括 125、250、500 和 1000 Hz，但支援的輪詢率會因滑鼠型號和接收器而異。請勿假定最高輪詢率可用。

RazerGenie 的輪詢率頁面，已為支援的滑鼠選擇 500 Hz。 — 從連接設備實際公開的輪詢速率中進行選擇。

5. 如果 RazerGenie 未偵測到您的裝置

檢查 USB 偵測：運行lsusb | grep 1532，然後將產品 ID 與穩定支援清單進行比較。
檢查守護進程：運行systemctl --user status openrazer-daemon.service；如果已停止，請嘗試systemctl --user restart openrazer-daemon.service。
核心更新後：確認已安裝匹配的頭文件，並且 DKMS 已為正在運行的核心建置了模組。
排除 USB 問題：重新連接設備，嘗試使用直連連接埠而不是集線器或 KVM 切換器，然後重新開啟 RazerGenie。

一旦 OpenRazer 檢測到硬件，RazerGenie 就會提供一種便捷的圖形化方式來調整特定週邊支援的燈光和設備控制。