Home Assistant IR RGB Light Integration

Home Assistant IR RGB Light Integration

This integration allows you to control "dumb" RGB LED lights (controlled via Infrared remotes) as if they were native smart lights in Home Assistant. It maps the HS (Hue & Saturation) color wheel and Brightness levels to specific IR button presses.

This was inspired by this video https://www.youtube.com/watch?v=yvfctsO6A8k.

✨ Features

• Native Color Wheel: Select any color; the integration automatically calculates and presses the closest configured IR button using circular angular distance.
• Proximity Mapping: If you only have 4 buttons (Red, Green, Blue, White), selecting "Orange" on the UI will automatically trigger the "Red" IR command.
• Adjustable Brightness Steps: Define how many levels of brightness your remote supports (e.g., 5 steps or 10 steps) for accurate dimming.
• Configurable Effects: Map Home Assistant light effects (Flash, Smooth) to your remote's effect buttons.
• Fully Configurable UI: No YAML needed. Setup and reconfigure buttons directly via the Integrations dashboard.

🛠️ Installation

HACS Installation

Or Search for IR RGB Light Mapper in HACS and install it under the "Integrations" category.

• Restart Home Assistant
• In the HA UI go to Settings -> Integrations click "+ Add integration" and search for "IR RGB Light Mapper"
• Follow Configuration steps to create your first entity

Manual Installation

More Details

• You should take the ir_light.zip file from the latest published release.
• To install, place the contents of custom_components into the <config directory>/custom_components folder of your Home Assistant installation.
• Restart Home Assistant
• In the HA UI go to Settings -> Integrations click "+ Add integration" and search for "IR RGB Light Mapper"
• Follow Configuration steps to create your first entity

⚙️ Configuration

During setup, you will be asked for:

1. Basic Config: Light name and mandatory IR buttons (On, Off, Brightness Up/Down).
2. Brightness Levels: The number of presses it takes to go from min to max brightness (Default: 5).
3. Mandatory Colors: Red, Green, Blue, and White buttons.
4. Optional Colors: 9 additional color buttons (Orange, Yellow, Cyan, Magenta, etc.) to increase color accuracy.

📝 Requirements

• A working IR Bridge (Broadcom, ESPHome, etc.) that exposes buttons to Home Assistant.
• The IR buttons must be already configured as button entities in your system.

⚖️ License

MIT License