Skip to content

Latest commit

 

History

History
43 lines (25 loc) · 3 KB

info.md

File metadata and controls

43 lines (25 loc) · 3 KB

GitHub Release License Community forum discussion Installations

Control your Chroma-enabled devices from Home Assistant

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.

Installation

  1. Click Install
  2. Restart Home Assistant
  3. In the Home Assistant UI: Configuration -> Devices & Services -> Integrations -> Add integration -> Chroma

Usage

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)

Allow the connection (adjust your firewall settings)

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.

Lights

The integration provides a light entity per each device selected during the configuration process. Every entity supports rgb_color and brightness attributes.

Services

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.


Buy Me A Coffee