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.

Note

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.

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.

Tip

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
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
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
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
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"