r/linuxhardware • u/SlainSavage • 17h ago
News Got the Ajazz AKP02 USB panel working on Linux
The Ajazz AKP02 (the 9.2" 1920×462 USB side panel sold as a case or desk stats screen) only ships with Windows software, so I wrote a Linux driver and a daemon to drive it.
- **[akp02](https://github.com/deonspengler/akp02)\*\* is the driver library: it talks to the panel over USB HID. MPL-2.0, so you can build your own app on it.
- **[akp02d](https://github.com/deonspengler/akp02d)\*\* is the app: a systemd user service that draws themes you design yourself. GPL-3.0-or-later.
**What it can show**
- Clock, CPU, memory, disk, network, temperatures, uptime, IP address
- An audio visualiser (bars, mirrored, segmented or radial, via cava)
- What's playing, with cover art, from any MPRIS player (Spotify, mpv, browsers...)
- The system volume, following your volume keys as you press them
**The theme editor**
`akp02d-edit` shows a live preview of the panel, and works without the panel plugged in. Drag widgets in, move and resize them, and pick colours, gradients, fonts and data sources. Labels, bars, gauges (arc, car-style dial or analog meter), graphs, the visualiser and images are all there. Hit **Apply to panel** and it's live.
**Running it**
It runs as a user service and can be controlled while running: `akp02d ctl theme <name>`, `akp02d ctl brightness 60`. Save a theme and the panel updates within a second; a theme with a mistake is refused rather than blanking the screen. At 30 fps it uses about 3 ms per frame here.
**Install**
- Arch: `yay -S akp02d` (the driver package includes the udev rule, so no root needed)
- Other distros: `pipx install 'akp02d[editor]'`, then the udev rule and service from the README
Then:
systemctl --user enable --now akp02d
It's my first release, so bug reports, feature ideas and themes are all welcome.




