Skip to content
fldcPublic

About

Rust CLI for configuring NuPhy keyboards: RGB lighting, key remapping, keymap backups, and sleep settings.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

43 Commits

Folders and files

Repository files navigation

nuphyctl

nuphyctl is a Rust CLI for sending NuPhy keyboard HID commands to boards supported by drive.nuphy.io.

  • Set main/backlight, side-light, and decorative RGB effects.
  • Read, remap, back up, and restore keymaps, including declarative TOML configuration.
  • Read and set automatic sleep, both sleep timers, and the knob/button accessory switch.
  • List HID devices and send raw reports for reverse engineering.

Installation

On Arch Linux, install nuphyctl-bin from the AUR:

yay -S nuphyctl-bin

For release binaries, source builds, and Cargo installation, see the setup guide.

Linux device permissions

The Arch package installs the required udev rule automatically. For other installation methods, follow the device permissions setup before accessing the keyboard. Running nuphyctl as root is not required.

Quick start

nuphyctl list
nuphyctl rgb set --hex ff8800 --brightness 35
nuphyctl keymap info
nuphyctl keymap dump --changed
nuphyctl settings get --accessory

Use nuphyctl --help or nuphyctl <command> --help to explore the CLI.

Documentation

  • Setup — installation, building, and Linux device permissions.
  • Release provenance — verification and release/AUR packaging procedures.
  • Command guide — lighting effects, keymaps, backups, device selection, and raw reports.
  • Reverse engineering — protocol notes and the DevTools capture workflow.

About

Rust CLI for configuring NuPhy keyboards: RGB lighting, key remapping, keymap backups, and sleep settings.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages