IR2MQTT

Appearance

IR2MQTTThe Ultimate IR Gateway

Bridge the gap between physical Infrared devices and your smart home.

Get Started
View on GitHub

Modern Web UI

Replaces tedious YAML configuration with a reactive Web UI to manage devices, learn IR codes, and create powerful automations.

MQTT Auto-Discovery

Integrates seamlessly into Home Assistant using MQTT Discovery, creating devices, buttons, and sensors automatically.

Integrated IR Database

Built-in support for thousands of IR codes from the Flipper Zero and Probono databases. Import them with a single click.

Getting Started ​

Follow these four steps to get IR2MQTT up and running:

1. Flash a Bridge

Flash an ESP32 with the IR2MQTT ESPHome firmware from the ir2mqtt_bridge repository. Connect an IR receiver (38 kHz) and an IR LED to the GPIO pins defined in the firmware config.

2. Connect to MQTT

Configure your MQTT broker credentials in the IR2MQTT add-on options (Home Assistant) or in /data/options.yaml (standalone Docker). IR2MQTT will auto-discover any bridge that connects to the same broker.

3. Add a Device

Open the Web UI and create a device — either from a built-in template, the IR Database, or manually. Use Learning Mode to capture codes from your physical remote.

4. Integrate with Home Assistant

Set the App Mode to Home Assistant. IR2MQTT will publish MQTT Discovery payloads automatically, creating button, binary_sensor, and device trigger entities in HA without any manual configuration.