aiochroma 0.3.0

API wrapper for communication with Razer Chroma devices

AIOChroma

[!TIP] As of July 2025, support for Razer Synapse 4 and the corresponding Chroma SDK is fixed. The basic RGB control is back to work with any compatible device. New features and more fixes will be added in the future.

AIOChroma is an API wrapper for communication with Razer Chroma devices.

Up till now, it is mostly used for the custom Chroma integration for Home Assistant. But you are welcome to use it for your purposes, as well as suggest new features which you would like to use.

A short presentation of the features can be found in this YouTube video.

Installation

Installation of the latest release is available from PyPI:

pip install aiochroma

Usage

This section is still under development.

Supported devices

This list provides only the models tested by me or other users.

Some of the devices might be in the group which you would not expect. This is not related to the integration but to the Chroma SDK.

Group	Devices
Chromalink	Chroma Addressable RGB Controller (link*) Mousepads: Goliathus Extended Chroma (link) Services: AuraConnect
Headset	Kraken 7.1 V2 (link), Kraken X USB (link)
Keyboard	BlackWidow Chroma (link), BlackWidow Elite(link), BlackWidow V3 Pro (link) Cynosa Chroma (link) Huntsman Elite (link), Huntsman V2 Analog (link)
Keypad	Tartarus V2 (link)
Mouse	Basilisk (link), Basilisk V3 Pro (link) DeathAdder V2 Pro (link) Mamba Tournament Edition (link) Viper Ultimate (link) (+ Mouse Dock) (link)
Mousepad	Base Station V2 Chroma (link) Firefly V2 (link) Monitor Stand Chroma (link) Mouse Bungee V3 Chroma (link)

* As an Amazon Associate I earn from qualifying purchases. Not like I ever got anything yet (:

Support the development

This library is a free-time project. If you like it, you can support me by buying a coffee.