SalastilandClaude Opus 5
f888b1ddbc
The K70 RGB PRO V2 (1B1C:1BB3) was detected but never lit: it blanked into software render mode and then fell back to its onboard effect. Getting it working turned up five faults, three of which affect every Corsair V2 device rather than just this keyboard. Packet size is now read from the HID report descriptor before the first write instead of being inferred from a reply. These devices come in a 64 byte and a 1024 byte flavour, and sending a short packet to a 1024 byte endpoint stalls it until the device is power cycled, so the size has to be known up front rather than after two short queries have gone out. CORSAIR_V2_PACKET_SIZE was 1024 while pkt_sze reached 1025, so every read using pkt_sze overran its stack buffer by a byte. The command helpers now use pkt_sze against buffers of the corrected size. The lighting resource probe ran before the device was placed in software render mode, where the answer is meaningless, and treated any error as "use resource 1". Devices that answer invalid or unsupported for resource 1 want the alternate lighting resource, which takes RGB triplets; this keyboard is one of them. The probe now runs after the render mode switch and distinguishes a stale open handle from an unsupported resource. Direct lighting writes were sized from the keymap, which covers only the keys that exist. The hardware expects its full slot count and ignores a short write, so corsair_v2_device carries an optional hw_led_count and the buffer map is padded to it. Set to 193 for this keyboard. The keepalive thread wrote LEDs on its first pass, because last_update_time was left at the clock epoch and so always read as older than the update period. That raced detection on the same HID handle with no locking, which both corrupted the transaction and could abort the process. The clock is now started before the thread runs, device transactions are serialised behind a mutex, and the thread is stopped before Shutdown rather than after. Also fixes an uninitialised stack buffer sent to the device during setup, and widens the K70 RGB PRO matrix to 22 columns so the numpad period key has a position in the layout instead of being dropped. Verified on hardware: repeated colour changes apply and the device stays responsive across runs. Co-Authored-By: Claude Opus 5 <[email protected]>
One of the biggest complaints about RGB is the software ecosystem surrounding it. Every manufacturer has their own app, their own brand, their own style. If you want to mix and match devices, you end up with a ton of conflicting, functionally identical apps competing for your background resources. On top of that, these apps are proprietary and Windows-only. Some even require online accounts. What if there was a way to control all of your RGB devices from a single app, on Windows, Linux, and MacOS, without any nonsense? That is what OpenRGB sets out to achieve. One app to rule them all.
Features
- Set colors and select effect modes for a wide variety of RGB hardware
- Save and load profiles
- Control lighting from third party software using the OpenRGB SDK
- Command line interface
- Connect multiple instances of OpenRGB to synchronize lighting across multiple PCs
- Can operate standalone or in a client/headless server configuration
- View device information
- No official/manufacturer software required
- Graphical view of device LEDs makes creating custom patterns easy
Website
- Check out our website at openrgb.org
Supported Devices
- See the Supported Devices page for the current list of supported devices.
WARNING!
This project interacts directly with hardware using reverse engineered protocols. While we do our best to make sure we're sending the right data, there is always some risk in sending data to hardware when we don't understand exactly how that hardware works. There have been issues in the past with certain hardware getting damaged/bricked and we have either disabled or fixed the offending code. That said, with OpenRGB always changing and the landscape of RGB devices being of widely varying quality, we can't guarantee it won't happen again. By installing and using OpenRGB you accept this risk.
Download OpenRGB
- Pre-built binaries are available for the following platforms:
- Windows
- Linux (AppImage, .deb, and .rpm)
- MacOS
- Released versions are available to download on OpenRGB.org or under Releases.
- Experimental (aka Pipeline) versions are available to download on OpenRGB.org.
- On Windows, you will need the Microsoft Visual 2019 C++ runtime installed. You can get it here.
- An official Flatpak release is available on Flathub
- Note: If using the AppImage or Flatpak versions, ensure you install the latest udev rules.
- Released versions are officially packaged for various distributions including Alpine, Fedora, and Arch.
- Arch users can also install from the Extra repository or from the AUR for the pipeline version.
Compile OpenRGB
- Instructions for compiling from source are available here.
Setup Device Access
- After installing OpenRGB, please see the SMBus Access and USB Access pages for instructions on setting up access to your RGB devices.
Join Our Discord
Follow Us On Mastodon
Visit Our Lemmy Community
How-Tos and FAQs
Support OpenRGB
- OpenRGB is a project I created to solve a problem I had with the RGB ecosystem. My goal isn't to make money off of this project. That said, people have requested to donate, and donations allow me to buy more RGB stuff to reverse engineer.
- Donate via PayPal
- Become a Patron (I'm not doing any Patreon-exclusive content, it's purely for donation)
- Donate via Bitcoin: 1N83YPu7btXYadPS1neB9zX7X1QTdpyZQ
History of OpenRGB
- OpenRGB is a continuation of OpenAuraSDK, which itself was created out of reverse engineering work done on the Keyboard Visualizer project. For a complete history of the RGB projects that led to OpenRGB's creation, see the History page.
Contributing
- Want to contribute support for a new device? Check out the RGBController API page for documentation of how OpenRGB implements device control.
- Want to create a new OpenRGB SDK client implementation? Check out the OpenRGB SDK Documentation page for documentation of how the OpenRGB SDK network protocol functions.
- Please read the Contributing Guidelines before starting work on your new changes.
OpenRGB SDK
-
OpenRGB provides a network interface for controlling supported RGB devices from other software. These projects implement the OpenRGB SDK and provide additional ways for you to control your lighting setup.
- OpenRGB Python Client (by jath03)
- OpenRGB Python Client (deprecated) (by bahorn)
- OpenRGB Node.js Client (by vlakreeh)
- D-Bus Connector for OpenRGB (by Vinno97)
- OpenRGB.NET - C# OpenRGB Client (by diogotr7)
- OpenRGB-Client - Java Client (by morg)
- OpenRGB-SDK - NodeJS client (by Mola19)
- OpenRGB-cppSDK - C++ client (by Youda008)
- openrgb-rs2 - Rust client (by nicoulaj & Achtuur)
Applications Supporting OpenRGB SDK
-
While OpenRGB itself only provides control over the lighting effects built into hardware, several open source applications can use the OpenRGB SDK to provide synchronized lighting effects for your devices.
- Keyboard Visualizer (by CalcProgrammer1)
- OpenRGB E1.31 Receiver (by me)
- Aurora (OpenRGB support added by diogotr7)
- Artemis (OpenRGB support added by diogotr7)
- RemoteLight (by Drumber, requires OpenRGB plugin)
- OpenRGB-python-FX (by herosilas12)
- AllMyLights (by sparten11740)
- OpenRGBRemote (by morg)
- PiLED (by PolisanTheEasyNick)
OpenRGB Plugins
-
OpenRGB provides a plugin interface for adding features to the OpenRGB application. The following projects provide additional functionality in the form of plugins.
- OpenRGB Effects Plugin (by herosilas12, morg)
- OpenRGB Visual Map Plugin (by morg)
- OpenRGB E1.31 Receiver Plugin (by CalcProgrammer1)
- OpenRGB Scheduler Plugin (by morg)
- OpenRGB Skin Plugin (by morg)
- OpenRGB Hardware Sync Plugin (by morg)
- OpenRGB Http Hook Plugin (by morg)
- OpenRGB Razer Extras Plugin (by morg)
- OpenRGB Fan Hardware Sync Plugin (by Shady)
- OpenRGB Ambient Plugin (by krojew)
Projects Used
- OpenRGB directly relies upon these projects.
- PawnIO: https://pawnio.eu/
- libusb: https://github.com/libusb/libusb
- hidapi: https://github.com/libusb/hidapi
- libe131: https://github.com/hhromic/libe131
- NVFC: https://github.com/graphitemaster/NVFC
- Qt-Plus (ColorWheel): https://github.com/liuyanghejerry/Qt-Plus
- AMD ADL Libraries: https://github.com/GPUOpen-LibrariesAndSDKs/display-library
- hueplusplus: https://github.com/enwi/hueplusplus
- httplib: https://github.com/yhirose/cpp-httplib
- mdns: https://github.com/mjansson/mdns
- macUSPCIO: https://github.com/ShadyNawara/macUSPCIO
Projects Researched
-
While no code from these projects directly made its way into OpenRGB, these projects have been invaluable resources for protocol information.
- OpenRazer: https://github.com/openrazer/openrazer
- OpenRazer-Win32: https://github.com/CalcProgrammer1/openrazer-win32
- ckb-next: https://github.com/ckb-next/ckb-next
- linux_thermaltake_riing: https://github.com/chestm007/linux_thermaltake_riing
- Aura Addressable Header Controller: https://gitlab.com/cneil02/aura-addressable-header-controller
- OpenPyAURA: https://gitlab.com/thelastguardian/openpyaura
- AsrLed: https://github.com/EUA/AsrLed
- asrock-leds: https://github.com/RattyDAVE/asrock-leds
- hue-plus: https://github.com/kusti8/hue-plus
- rogauracore: https://github.com/wroberts/rogauracore
- msi-rgb: https://github.com/nagisa/msi-rgb
- OpenCorsairLink: https://github.com/audiohacked/OpenCorsairLink
- msi-keyboard: https://github.com/bparker06/msi-keyboard
- rivalcfg: https://github.com/flozz/rivalcfg
- VRMTool: https://github.com/rbrune/VRMtool
- g810-led: https://github.com/MatMoul/g810-led
- liquidctl: https://github.com/jonasmalacofilho/liquidctl
- kraken-unleashed: https://github.com/Cesarsk/kraken-unleashed
- Annemone: https://github.com/manualmanul/Annemone
- libcmmk: https://github.com/chmod222/libcmmk
- Signal RGB Plugins: https://gitlab.com/signalrgb/signal-plugins/-/tree/master/Plugins
- k550-macos: https://github.com/vookimedlo/ck550-macos/tree/master
- luxafor-python: https://github.com/vmitchell85/luxafor-python
- dreamcheekyusb: https://github.com/gbrayut/dreamcheekyusb
- omen-light: https://github.com/chiahsing/omen-light