Repository navigation
ak820-linux 0.3.0
⚠️ Use 0.3.1 instead. In 0.3.0,ak820 musicwithout--colorscrashes. The GUI is not affected.
What's new: music mode
The keys react to whatever your PC is playing. It works the way the vendor's Windows app does: the PC captures the system audio and streams live per-key frames to the keyboard (op 0x20, about 17 frames per second). Nothing is written to the keyboard's flash, and your saved effect comes back by itself when you stop.
- Styles: Meter (fills left→right), Center (fills outwards from the middle), Spectrum (16-band equalizer, bass on the left, rows fill from the bottom), Pulse (the whole keyboard flashes on each beat and changes color).
- Colors: Classic (green→yellow→red), Rainbow, or two colors of your choice.
- GUI: a new ♫ Music page with Start/Stop, style, colors and sensitivity. Changes apply while it runs, and they're saved with your settings and profiles.
- CLI:
ak820 music [--style meter|center|spectrum|pulse] [--colors classic|rainbow|RRGGBB-RRGGBB] [-g SENSITIVITY], stop with Ctrl-C. - The protocol table in the README now documents op
0x20.
Dependencies
- Music mode needs
parec(packagepulseaudio-utils). It works with PipeWire too. - The Spectrum style also needs numpy (
python3-numpy). Everything else works without it.
sudo dnf install pulseaudio-utils python3-numpy # Fedora
sudo apt install pulseaudio-utils python3-numpy # Debian / UbuntuThe music mode is only on main (Qt GUI and CLI). The tk-gui branch doesn't have it.
Install / upgrade
curl -L https://github.com/hcristosm/ak820-linux/archive/refs/tags/v0.3.0.tar.gz | tar xz
cd ak820-linux-0.3.0 && ./install.shRunning install.sh over an older version upgrades it in place.