I’ve recently switched to a Razer Ornata Chroma, a “mecha-membrane” keyboard, which comes with individually controllable RGB-LED backlights for each key. There are a few GUI tools that let you configure the lighting settings on Linux already, like RazerGenie or RazerCommander, but I really wanted to control it from the command-line and Beehive instead: imagine your keyboard indicating new notifications and events by a cheer- and colorful illumination.
Naturally, this meant firing up my editor and hacking on a new Go library, which I’ve aptly named go-razer. Luckily the openrazer drivers provide a dbus interface that is fairly straight-forward to work with, and go-razer is just a thin Go wrapper around the exposed methods. This also means that a whole variety of Razer Chroma products are supported out of the box, since all the hardware specific abstractions are already handled by openrazer.
With my convenient little Go package done, I’ve started working on Lantern, a command-line tool to control my shiny new keyboard.
The keyboard provides a couple of effects that seem to be baked into the
firmware of the device. The ones available as of firmware 1.0 are called
ripplerandom. You can
activate them from the command-line by running:
$ lantern -effect wave
$ lantern -effect starlightdual -color "#00ff00" -secondary "#aa00aa"
Plain Background Color
If the effects are bit too much for your liking, you can also set a plain background color for the entire keyboard:
$ lantern -color "#6b6b00"
Lantern also supports custom software effects, which means you can turn your keyboard into a fancy gauge, monitoring your system’s CPU usage. This is the mode that people seem to enjoy the most:
$ lantern -top
There are currently only a few available themes (feel free to submit more!)
random. To activate a theme run:
$ lantern -theme happy
Last but not least, you can change the entire keyboard’s brightness (values in percent):
$ lantern -brightness 80
This parameter can also be used in combination with any of the modes described above.
Help Me Testing
In theory go-razer and Lantern should work with all kinds of Razer Chroma keyboards, mice and laptops, but I currently only have the Ornata keyboard to test it with. Please get in touch if you tried using it with other Razer products and let me know what works and what needs fixing.
You can check out both projects on GitHub.