Transform your smart home lighting with the power of SignalRGB, now integrated directly into Home Assistant!
Features β’ Requirements β’ Installation β’ Configuration β’ Usage β’ Development β’ Contributing β’ Support
- π‘ Control SignalRGB as a light entity in Home Assistant
- π Seamless on/off control
- π¨ Apply a wide range of lighting effects
- π Adjust brightness of your entire SignalRGB setup
- π View current effect and available effects list
- π Automatic effect image and color extraction
- ποΈ Effect parameter control (coming soon!)
Want more features? Vote for this SignalRGB feature request!
- Home Assistant 2024.2.0 or newer
- SignalRGB software installed and running on a Windows PC on your network
- SignalRGB HTTP API enabled (default port: 16038)
- SignalRGB Pro subscription (required for API)
- Ensure that HACS is installed in your Home Assistant instance.
- In the HACS panel, go to "Integrations".
- Click the "+" button in the bottom right corner.
- Search for "SignalRGB" and select it.
- Click "Install" and wait for the installation to complete.
- Restart Home Assistant.
Note: This component isn't in the official HACS repository yet. You can add it as a custom repository:
- Go to HACS
- Click on the three dots in the top right corner
- Select "Custom repositories"
- Enter "hyperb1iss/signalrgb-homeassistant" for the repository
- Select "Integration" for the category
- Click "Add"
- Download the
signalrgb
folder from this repository. - Copy the folder to your
custom_components
directory in your Home Assistant config directory.- If the
custom_components
directory doesn't exist, you'll need to create it.
- If the
- Restart Home Assistant.
Ensure that the SignalRGB API is enabled and accessible:
- Open SignalRGB on your Windows PC.
- Go to Settings > General > Enable HTTP API.
- Note the port number (default is 16038).
- If necessary, configure your Windows firewall to allow incoming connections on this port.
After installation, add the SignalRGB integration through the Home Assistant UI:
- Navigate to Configuration > Integrations.
- Click the "+" button to add a new integration.
- Search for "SignalRGB" and select it.
- Enter the hostname or IP address of the PC running SignalRGB and the port number.
- Click "Submit" to add the integration.
Once configured, SignalRGB will appear as a light entity in Home Assistant. You can:
- π‘ Turn it on/off
- π¨ Select different effects from the effect list
- π Adjust the brightness of your entire SignalRGB setup
- π Include it in automations, scripts, and scenes
- ποΈ View effect details and parameters
Example automation:
automation:
- alias: "Gaming Time"
trigger:
platform: state
entity_id: binary_sensor.gaming_pc_status
to: 'on'
action:
- service: light.turn_on
target:
entity_id: light.signalrgb
data:
effect: "Cyberpunk 2077"
brightness: 255
You can also control the brightness using slider controls in the Home Assistant UI or by calling the light.turn_on
service with a brightness value:
service: light.turn_on
target:
entity_id: light.signalrgb
data:
brightness: 128 # Values range from 0 (off) to 255 (full brightness)
To take your SignalRGB control to the next level, check out the hyper-light-card for Home Assistant! This custom card provides a beautiful, intuitive interface for controlling your SignalRGB setup, featuring:
- π Dynamic color adaptation based on the current effect
- π Detailed effect information display
- πΌοΈ Effect preview images
- π§ Easy effect switching and parameter control
To install hyper-light-card:
- Add it to HACS as a custom repository (Frontend category)
- Install it through HACS
- Add a new card to your dashboard and select "Hyper Light Card"
- Choose your SignalRGB entity
Experience the perfect blend of functionality and aesthetics with hyper-light-card and SignalRGB!
This project uses Poetry for dependency management and packaging. To set up the development environment:
- Install Poetry
- Clone the repository:
git clone https://github.com/hyperb1iss/signalrgb-homeassistant.git
- Navigate to the project directory:
cd signalrgb-homeassistant
- Install dependencies:
poetry install
- Activate the virtual environment:
poetry shell
- Install pre-commit hooks:
pre-commit install
- Run tests:
make test
- Lint code:
make lint
- Format code:
make format
- Run all checks:
make check
We welcome contributions to the SignalRGB Home Assistant Integration! Here's how you can help:
- Fork the repository
- Create a new branch:
git checkout -b feature/your-feature-name
- Make your changes and commit them using Gitmoji:
git commit -m ":sparkles: Add amazing feature"
- Push to the branch:
git push origin feature/your-feature-name
- Submit a pull request
Please ensure your code adheres to our style guidelines and passes all tests.
- π For documentation and general questions, check out our Wiki.
- π Found a bug? Open an issue.
- π‘ Have a feature idea? Submit a feature request.
- π¬ For general discussion, join our Discord community.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
This integration is not officially affiliated with or endorsed by WhirlwindFX or SignalRGB. Use at your own risk.
Created by Stefanie Jane π
If you find this project useful, buy me a Monster Ultra Violet! β‘οΈ