Chroma
is a custom integration for Home Assistant to control your Razer Chroma-enabled devices using the AIOChroma python library.
Please, refer to the GitHub Readme for detailed information on the available sensors and controls.
A short presentation of the features can be found in this YouTube video.
- Click Install
- Restart Home Assistant
- In the Home Assistant UI:
Configuration -> Devices & Services -> Integrations -> Add integration -> Chroma
To connect you need to provide the following data:
- IP address or hostname
- Which devices do you want to control (e.g.
chromalink
,headset
,keyboard
,keypad
,mouse
,mousepad
) - Layout of your keyboard (if the
keyboard
option is selected)
In order to use the integration, you might need to adjust your firewall settings on the device with Chroma devices. Please, allow the incoming TCP
connection on port 54236
from your HA instance. In case, this connection is not allowed, the integration will not be able to connect and might be stuck in the configuring
state for an extended period.
The integration provides a light entity per each device selected during the configuration process. Every entity supports rgb_color
and brightness
attributes.
The chroma.service_send_message
service allows sending any string message to your per-key RGB keyboard. The message will be displayed symbol by symbol. Please, refer to the how-to documentation for more details.
Currently, the following keyboard layouts are supported: EN_US
.
You can still use the service if your keyboard layout is not yet supported. E.g. you can change your string from Lazy fox was here
to Layz fox was here
to properly be displayed with the German layout.