One desktop app for all the RGB lighting in and around your computer: keyboards, mice, case fans, motherboards and more, whatever the brand.
Most lighting hardware ships with its own Windows-only app, one per brand. clcr aims to be a single, lightweight control center for all of it on Linux:
- One window for every device, plus one-click "same color everywhere".
- No dependencies. Pure Python 3 standard library plus tkinter. No daemon, no browser, no vendor software. Drivers talk to the hardware directly through Linux hidraw.
- Open and extensible. Each device family is a small, self-contained driver, so adding a brand doesn't mean touching the rest. See Contributing.
It currently supports three devices and is meant to grow to cover most lighting hardware on the market.
| Type | Brand | Device | Status |
|---|---|---|---|
| Keyboard | Akko | 5075B Plus-S: per-key backlight, sidelights | ✅ Tested by maintainer |
| Keyboard | Any | VIA/QMK keyboards with RGB matrix (Keychron, Glorious, KBDfans, …) | 🟡 Untested |
| Motherboard / ARGB | ASUS | Aura USB controller, TUF GAMING B550-PLUS (0b05:1939) |
✅ Tested by maintainer |
| Motherboard / ARGB | ASUS | Other Aura USB mainboard controllers (1867, 1872, 18a3, 18a5, 18f3, 19af, 1aa6) |
🟡 Untested |
| Mouse | Logitech | G502 (SE) HERO: lighting, DPI, polling rate, onboard mode | ✅ Tested by maintainer |
| Mouse | Logitech | Other HID++ 2.0 mice with RGB (0x8070) |
🟡 Untested |
✅ tested by maintainer · 🤝 community tested (by the named contributor) · 🟡 untested: same protocol as a tested device, should work. Tried one? Please report how it went.
Wanted: MSI Mystic Light, Gigabyte RGB Fusion 2 and ASRock Polychrome motherboards (in caselight), and keyboards, mice, headsets, fan hubs, GPUs and RAM from Corsair, Razer, SteelSeries, HyperX, NZXT, Lian Li and others. Open a device request, or add support yourself: CONTRIBUTING.md explains how.
clcr is maintained by one person, who can only test the hardware on their own desk. Support for everything else comes from the people who own it:
- You write the driver and test it on your hardware. Use
clcr --demoand the tests while developing, and your own device to confirm it works. - You open a pull request with a hardware test report. The pull request template asks for the model, the USB ID, what works and what doesn't.
- The maintainer reviews the code, not the hardware. The review checks that the code is readable, talks only to its own device, uses only the Python standard library and comes with an emulated device and tests. The maintainer can't test your device, so the merge relies on your report.
- You become the driver's maintainer. You're listed below, the device is marked 🤝 community tested with your name, and you're asked to review future changes to your driver.
If a driver breaks and nobody with the hardware can fix it, it is marked unmaintained and may be removed in a later release.
| Driver | Code | Maintainer |
|---|---|---|
| VIA keyboards | viactl → clcr/backends/via/ |
@vaisajuh |
| ASUS Aura | caselight → clcr/backends/aura/ |
@vaisajuh |
| Logitech HID++ | logiled → clcr/backends/logitech/ |
@vaisajuh |
Use at your own risk. clcr is provided as is, without warranty (see LICENSE). Drivers avoid commands that change firmware or settings permanently, and community drivers are reviewed but not tested by the maintainer. A bug in a driver or in a device's firmware can still leave a device in an odd state.
git clone https://github.com/vaisajuh/clcr.git
cd clcr
./install.shThis installs tkinter (python3-tk) if missing, a udev rule so your user can
access the devices without root (/etc/udev/rules.d/70-clcr.rules), the clcr
command and a "Computer Lighting Control Center" app-menu entry. Replug your
devices afterwards if they aren't found.
clcr # or ./clcr-run from this folder
clcr --demo # emulated devices, no hardware is touchedThe Overview tab shows which devices are connected and can set every device to one solid color, or turn all lights off, in one click. Each device also has its own tab with everything it supports.
- Changes apply live. The keyboard writes to its EEPROM about 1.5 s after you stop adjusting.
- Case hardware modes keep running after the app closes. Software
effects are drawn by the app, so they stop (freeze) when you close it.
The last software effect resumes the next time the app opens. Don't run
another Aura tool (OpenRGB,
caselight serve) at the same time, or they will fight over the LEDs. - The mouse can't report its current lighting, so the Mouse tab shows the
settings you last applied (stored in
~/.config/clcr/config.json). - Settings live in
~/.config/clcr/(config.json, andcaselight.jsonfor ARGB LED counts and the last case lighting). - The keyboard must be connected by USB cable in wired mode.
- The udev rule covers Akko keyboards. For another VIA keyboard, add a line
with its USB vendor ID to
clcr/data/70-clcr.rulesand run./install.shagain.
tkinter main thread one worker thread per device hardware (hidraw)
┌────────────────┐ submit() ┌──────────────────────┐ ┌──────────────┐
│ Overview tab │ ───────────▶ │ DeviceWorker │ ─────────▶ │ VIA keyboard │
│ Keyboard tab │ │ job queue, │ │ ASUS Aura │
│ Case tab │ ◀─────────── │ stale jobs dropped │ ◀───────── │ G502 mouse │
│ Mouse tab │ post() └──────────────────────┘ └──────────────┘
└────────────────┘
- No dependencies. Everything is the Python 3 standard library plus
tkinter. The device drivers in
clcr/backends/read and write/dev/hidrawNdirectly, so no libusb, hidapi or daemon is needed. - Drivers come from the single-device projects.
backends/viaisvia.pyandfake.pyfrom viactl,backends/auraisaura.py,core.py,effects.pyandconfig.pyfrom caselight, andbackends/logitechishidpp.pyanddevice.pyfrom logiled. They are copied in, not imported, so clcr installs and runs on its own. A weekly workflow keeps the copies up to date (see Contributing). Protocol details are explained in those repos' READMEs. - The GUI never waits for USB. Tk may only be used from the main thread,
and a slow or unplugged device could otherwise freeze the window. Each
device gets its own
DeviceWorkerthread (worker.py); results and errors come back through a queue that the main loop drains every 30 ms. One device failing never blocks the others. - Sliders don't flood the device. Changes go through a
Debouncer(120–300 ms), and jobs submitted with the same key replace older queued ones. Writes to the devices' memory are delayed further (the keyboard saves to EEPROM 1.5 s after you stop), which also saves flash wear. - Tabs adapt to the device.
panels/base.pyhandles connecting, reconnecting and error states. Each tab builds its controls from what the device reports: keyboard zones and current settings, the Aura zone list, and the mouse's lighting zones, supported effects, DPI values and rates. - Demo mode.
devices.pycan return emulated devices instead of real ones (clcr --demo), which the tests also use. - Look. A dark theme on top of ttk's
clamtheme (theme.py).
Layout: clcr/app.py (window), clcr/panels/ (one tab per device),
clcr/worker.py, clcr/devices.py, clcr/backends/, clcr/widgets.py
(color button, labelled slider, debouncer).
Ideas, roughly in order. Help with any of them is welcome.
- A device registry, so new drivers plug in without editing
app.py - More brands: Corsair, Razer, SteelSeries, HyperX, NZXT, Lian Li, MSI and Gigabyte motherboards, GPU and RAM lighting
- Lighting profiles and scenes, saved and switched in one click
- Effects synced across all devices
- Packaging: PyPI, Flatpak, distro packages
Contributions are very welcome: bug reports, device test reports, new device support and code.
- Report a bug or request a device: open an issue.
- Change the keyboard, motherboard or mouse driver: open a pull request in viactl, caselight or logiled. Merged changes reach clcr automatically.
- Change the app, or add a new device: open a pull request here.
CONTRIBUTING.md explains the workflow, how to add a device and the few ground rules.
python3 -m unittest discover -s tests
python3 scripts/sync_backends.py --verify # bundled drivers are unedited
clcr --demoMaintained by Juha Väisänen (@vaisajuh). Questions, ideas and bug reports are welcome as GitHub issues.
Part of a small set of Linux lighting tools, all pure Python with no third-party dependencies:
- clcr (this repo): Computer Lighting Control Center, one desktop app for lighting across brands and devices (bundles the drivers below)
- viactl: VIA/QMK keyboards (tested on Akko 5075B Plus-S): RGB backlight, sidelights, keymap and macros
- caselight: motherboard and case lighting (currently ASUS Aura)
- logiled: Logitech G502 HERO mouse: lighting, DPI, polling rate and onboard mode
The ASUS Aura protocol follows the documentation of the OpenRGB project.
MIT. See LICENSE.