Remote
The Remote integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] manages remote entities and lets you control devices through them.
- Maintains a state for each of your remotes.
- Provides actions to turn remotes on or off, toggle them, send commands, learn commands, and delete commands.
Building block integration
This remote 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 remote 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 remote building block offers.
The state of a remote entity
The state of a remote entity can be either On or Off.
Good to know
The entity can also have the following states:
- Unavailable: The entity is currently unavailable.
- Unknown: The state is not yet known.
List of triggers
The Remote integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following triggers. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.
-
Remote turned off (
remote.turned_off) Triggers after one or more remotes turn off. -
Remote turned on (
remote.turned_on) Triggers after one or more remotes turn on.
For an overview of every trigger across all integrations, see the triggers reference.
List of conditions
The Remote integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following conditions. Each link below opens a dedicated page with examples, fields, and a step-by-step UI walkthrough.
-
Remote is off (
remote.is_off) Tests if one or more remotes are off. -
Remote is on (
remote.is_on) Tests if one or more remotes are on.
For an overview of every condition across all integrations, see the conditions reference.
List of actions
The Remote integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.
-
Delete remote command (
remote.delete_command) Deletes one or more learned commands from a supported remote entity. -
Learn remote command (
remote.learn_command) Teaches a supported remote entity one or more commands. -
Send remote command (
remote.send_command) Sends one or more commands through a remote entity. -
Toggle via remote (
remote.toggle) Sends the toggle command through a remote entity. -
Turn off via remote (
remote.turn_off) Sends the turn off command through a remote entity. -
Turn on via remote (
remote.turn_on) Sends the turn on command through a remote entity. Some remotes can also start a specific activity.
For an overview of every action across all integrations, see the actions reference.
Remote automation examples
These examples show common ways to use remote actions in automations. The exact command names and devices depend on your remote integration.
You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.
Automation: send a play command after the TV turns on
When the living room remote turns on, wait briefly and send a play command to the TV.
-
Trigger: Remote turned on
- Target: Living room remote
-
Action: Send remote command
- Target: Living room remote
- Device: television
- Command: play
YAML example for sending a play command
alias: "Send play when the TV remote turns on"
triggers:
- trigger: remote.turned_on
target:
entity_id: remote.living_room
actions:
- delay: "00:00:05"
- action: remote.send_command
target:
entity_id: remote.living_room
data:
device: television
command: play
Automation: start a saved activity at sunset
At sunset, start a saved evening activity on a remote that supports activities.
-
Trigger: Sun
- Event: Sunset
-
Action: Turn on via remote
- Target: Living room remote
- Activity: Evening TV
YAML example for starting an evening activity
alias: "Start evening TV activity at sunset"
triggers:
- trigger: sun
event: sunset
actions:
- action: remote.turn_on
target:
entity_id: remote.living_room
data:
activity: "Evening TV"