Skip to content

ak820-linux 0.3.0

Choose a tag to compare

@hcristosm hcristosm released this 16 Oct 15:36
· 18 commits to main since this release

⚠️ Use 0.3.1 instead. In 0.3.0, ak820 music without --colors crashes. 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 (package pulseaudio-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 / Ubuntu

The 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.sh

Running install.sh over an older version upgrades it in place.