A command-line utility for controlling lighting modes and key mappings on NuPhy 75 keyboard from Linux.
- Set keyboard animation modes (with adjustable brightness and speed)
- Set individual key mappings
- Communicates directly with the keyboard via USB HID
./nuphy_linux --set-mode <mode_index> <brightness> <speed>
./nuphy_linux --set-key <key_name> <key_value>
The indexing is from left to right top to bottom
-
--set-mode <mode_index> <brightness> <speed>
Sets the lighting animation mode.<mode_index>: Integer index of the animation mode (see below)<brightness>: 0-4 (0=lowest, 4=highest)<speed>: 0-4 (0=slowest, 4=fastest)
-
--set-key <key_index> <key_value>
Sets the value for a specific key.<key_index>: Name of the key to set<key_value>: Value to assign to that key
./nuphy_linux --set-mode 3 2 4
./nuphy_linux --set-key 2 F1
Each mode supports brightness and speed settings from 0 (lowest) to 4 (highest).
| Index | Mode Name |
|---|---|
| 0 | on |
| 1 | respire |
| 2 | rainbow |
| 3 | flashaway |
| 4 | raindrops |
| 5 | rainbow_wheel |
| 6 | ripples_shining |
| 7 | stars_twinkle |
| 8 | shadow_disappear |
| 9 | retro_snake |
| 10 | neon_stream |
| 11 | reaction |
| 12 | sine_wave |
| 13 | retinue_scanning |
| 14 | rotating_windmill |
| 15 | colorful_waterfall |
| 16 | blossoming |
| 17 | rotating_storm |
| 18 | collision |
| 19 | perfect |
| 20 | game_mode |
| 21 | off |
nuphy_linux/
├── src/ # C source files
├── include/ # Header files
├── build/ # Compiled output (optional)
├── nuphy_linux # Compiled binary
├── Makefile # Build instructions
├── README.md
This project uses a standard Makefile.
-
Ensure you have
gccandlibusb-1.0installed. -
Build with:
make -
The resulting binary
nuphy_linuxwill be created.
- libusb-1.0 (for USB communication)
On Ubuntu/Debian, install with:
sudo apt-get install libusb-1.0-0-dev
Pull requests are welcome! Please open issues for feature suggestions or bug reports.
MIT License
Note:
This project is not affiliated with or endorsed by NuPhy. Use at your own risk.