mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-23 10:36:50 +00:00
43 lines
1.5 KiB
Markdown
43 lines
1.5 KiB
Markdown
---
|
|
title: Remote
|
|
description: Instructions on how to setup your remotes with Home Assistant.
|
|
ha_release: 0.34
|
|
ha_domain: remote
|
|
ha_category:
|
|
- Remote
|
|
ha_quality_scale: internal
|
|
ha_codeowners:
|
|
- '@home-assistant/core'
|
|
ha_integration_type: entity
|
|
---
|
|
|
|
The **Remote** {% term integration%} manages the state of the remote entities and allows you to control them.
|
|
|
|
- Maintains a state per remote and a combined state `all_remotes`.
|
|
- Registers actions `remote.turn_on`, `remote.turn_off`, `remote.toggle`, and `remote.send_command` to control remotes.
|
|
|
|
{% include integrations/building_block_integration.md %}
|
|
|
|
## The state of a remote entity
|
|
|
|
The state of a remote entity can be either **On** or **Off**.
|
|
|
|
In addition, the entity can have the following states:
|
|
|
|
- **Unavailable**: The entity is currently unavailable.
|
|
- **Unknown**: The state is not yet known.
|
|
|
|
## Use the actions
|
|
|
|
Go to the **Developer Tools** and open the **Actions** tab. From the **Actions** dropdown, choose `remote.turn_on`, `remote.turn_off`, or `remote.toggle`. Under target, select the target device. If you are in YAML mode, enter something like the sample below into the **Data** field. Once you are done, select **Perform action**.
|
|
|
|
```json
|
|
{"entity_id":"remote.family_room"}
|
|
```
|
|
|
|
| Data attribute | Optional | Description |
|
|
| -------------- | -------- | ----------------------------------------------- |
|
|
| `entity_id` | yes | Only act on a specific remote, else target all. |
|
|
|
|
See the platform documentation for each type of remote for more detailed examples.
|