openajazz

Control AJAZZ keyboards without the Windows app: lighting effects, per-key RGB, key remaps, macros, music sync, sleep and battery. Works over the USB cable or the 2.4G dongle.

Supported keyboards

Have another AJAZZ board? Open an issue with the output of openajazz devices and the name of the vendor driver package; most of them share this protocol.

Get it

Pick one:

Linux permissions

Once, so you don't need sudo (the web app needs this too):

openajazz udev --install      # then replug the keyboard or dongle

It only opens the keyboard's settings interface to your user, never the typing one.

Use it

openajazz                          # full-screen TUI
openajazz status                   # battery
openajazz light breathing -c cyan  # effect + colour (openajazz modes lists them)
openajazz lights off               # and `on` brings your lighting back
openajazz custom -a 101010 w=red a=red s=red d=red
openajazz remap capslock esc
openajazz macro f12 +lctrl c -lctrl
openajazz music --background       # lights follow what's playing, terminal can close
openajazz autostart music          # ...and start that at every login
openajazz --help                   # everything else

Coming from ak820ctl? Same commands under the new name; your saved settings and presets move over on first run.

What doesn't work (yet)

• Bluetooth: plug in the cable or dongle to change settings.
• Phones: browsers on phones don't support WebHID.
• Firmware updates and mouse-button assignments aren't supported.

More detail: CHANGELOG · PROTOCOL.md · issues

Credits

Hardware test results, the colour palette, live-frame behaviour and the effect previews come from prasoondev/ajazz-linux (MIT).

MIT licensed. "AJAZZ" and "AK820" are trademarks of their owner, used here only to say what hardware this is for.