Infrared
The Infrared integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to use Home Assistant to send commands to infrared-controlled devices, or to receive signals from infrared remotes. The integration acts as an abstraction layer between the following components:
- An infrared remote adapter (proxy) hardware
- An integration that provides infrared entities by integrating an infrared remote adapter (such as ESPHome or SMLIGHT SLZB)
- Device-specific integrations (such as LG Infrared or Samsung Infrared)
This page documents the Infrared integration. To learn more about infrared control in Home Assistant, refer to Infrared.
You can control infrared-controlled devices from Home Assistant without touching the handheld remote control. You can also send signals from the handheld remote control to Home Assistant. The chart illustrates how this is possible via the integrations.
How the Infrared integration connects device integrations to an infrared remote adapter through a remote adapter integration.
An infrared entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] represents either an infrared emitter or an infrared receiver.
Building block integration
This infrared is a building block integration that cannot be added to your Home Assistant directly but is used and provided by other integrations.
A building block integration differs from the typical integration that connects to a device or service. Instead, other integrations that do integrate a device or service into Home Assistant use this infrared building block to provide entities, services, and other functionality that you can use in your automations or dashboards.
If one of your integrations features this building block, this page documents the functionality the infrared building block offers.
Infrared states
An infrared entity has no on or off state. Its stateThe state holds the information of interest of an entity, for example, if a light is on or off. Each entity has exactly one state and the state only holds one value at a time. However, entities can store attributes related to that state such as brightness, color, or a unit of measurement. [Learn more] is a timestamp showing when the entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] was last active:
- For an emitter, the state is the date and time the last IR command was sent.
- For a receiver, the state is the date and time the last IR signal was received.
Home Assistant stores the timestamp in UTC, for example, 2026-01-01T12:00:00.123+00:00. The Home Assistant interface shows it in your local date and time format.
In addition, the entity can have the following states. Each item shows the interface label, followed by the stored state:
-
Unavailable (
unavailable): The entity is currently unavailable. -
Unknown (
unknown): The state is not yet known.
Because the stateThe state holds the information of interest of an entity, for example, if a light is on or off. Each entity has exactly one state and the state only holds one value at a time. However, entities can store attributes related to that state such as brightness, color, or a unit of measurement. [Learn more] of an infrared entity is a timestamp, it changes every time the entity is used. This means you can use it to track when the emitter last sent a command, or when the receiver last picked up a signal. The logbook can also show context about which integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] or actionAn action makes Home Assistant do something, for example, turn on a light, send a notification, or activate a scene. Automations and scripts run a list of actions. [Learn more] triggered the IR event.
Device class
The device class tells Home Assistant whether an infrared entity is an emitter or a receiver. Home Assistant uses the device class to choose the icon and the default name, and to show the type of each adapter in the list of infrared remote adapters.
Home Assistant sets the device class automatically, based on whether the entity sends or receives IR signals. You can’t change the device class.
Device classes in automations and templates
- Automations: The device class doesn’t change how an infrared entity works in automations.
- Templates: The device class is the
device_classattribute of the entity. Use the stored value, such asemitter. For example, you can find entities by device class.
List of available device classes
Each item shows the name you see in the Home Assistant interface, followed by the device class as Home Assistant stores it.
-
Infrared emitter (
emitter): Sends IR signals to an infrared-controlled device. -
Infrared receiver (
receiver): Receives IR signals, for example from a handheld remote.
Troubleshooting
For problems with infrared control, such as a device that does not respond to commands, refer to Troubleshooting infrared control.