A native Quickshell bar plugin for lighting control, Omarchy theme sync, and
keymap editing on NuPhy keyboards supported by
nuphyctl.
- Independent backlight and side-light controls with per-zone Omarchy theme sync.
- Visual Air75 V3 keymap editor and a matrix view for other layouts.
- Auto Sleep, sleep timers, and opt-in swappable knob/button settings.
- Shared editing drafts across monitors, explicit Apply, and keymap recovery backups.
Requires Omarchy’s Quickshell-based shell, Python 3, and nuphyctl on PATH.
Keyboard settings require nuphyctl 0.7.0 or newer.
omarchy pkg aur add nuphyctl-bin
omarchy plugin add https://github.com/fldc/omarchy-nuphy.git --enableInstalling the plugin does not install the CLI or grant HID device access. After installing the CLI package, reconnect the keyboard while logged into your local desktop session. Run the plugin and CLI as your normal user. See the installation guide for permissions, upgrades, and removal.
Click the keyboard icon in the bar to open Lighting, Keymap, or Settings. Edit your preferences and use the tab’s Apply button to write changes. Theme sync starts disabled; enable Follow Omarchy theme for each zone you want to sync.
Open the popup from a keybinding or terminal with omarchy-shell nuphy toggle.
See the usage guide for lighting, keymap editing, and keyboard
settings.
- Installation, permissions, upgrades, and removal
- Lighting, keymaps, and keyboard settings
- Local development and testing
- Settings integration validation
- 0.3.0 validation and remaining manual checks
- Roadmap
MIT. The screenshots and marketplace preview are included under the same license.
