jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Correct documentation for Apple TV (#3004)

Browse source 
* Correct documentation for Apple TV

* Minor style updates
This commit is contained in:
Pierre Ståhl 2017-07-18 21:39:12 +02:00 • committed by Fabian Affolter
parent 15eba5ac28
commit fda6aa2be6
7 changed files with 192 additions and 37 deletions
Download patch file Download diff file Expand all files Collapse all files

39
source/_components/media_player.apple_tv.markdown
View file

@ -9,43 +9,8 @@ sharing: true
footer: true
logo: apple.png
ha_category: Media Player
ha_iot_class: "Local Polling"
ha_iot_class: "Local Push"
ha_release: 0.38
featured: true
---
The `apple_tv` platform allows you to control an Apple TV (3rd and 4th generation).
<p class='note'>
Currently you must have Home Sharing enabled for this to work. Support for pairing Home Assistant with your device will be supported in a later release.
</p>
If you want to automatically discover new devices, just make sure you have `discovery:` in your `configuration.yaml` file. To manually add an Apple TV to your installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
media_player:
- platform: apple_tv
host: IP_ADDRESS
login_id: LOGIN_ID
```
Configuration variables:
- **host** (*Required*): The IP-address of the device
- **login_id** (*Required*): An identifier used to login to the device, see below
- **name** (*Optional*): The name of the device used in the frontend
In order to connect to the device you need a *login id*. The easiest way to obtain this identifier is to use the application ``atvremote``. It should be available in the same environment as you installed Home-Assistant. To install this utility, run ``pip3 install --upgrade pyatv``. The run atvremote scan for all devices (try again if a device is missing):
```bash
$ atvremote scan
Found Apple TVs:
- Apple TV at 10.0.10.22 (login id: 00000000-1234-5678-9012-345678901234)
```
Just copy and paste the login id from the device you want to add. For more details about `atvremote`, see: [this page](https://github.com/postlund/pyatv/blob/master/docs/atvremote.rst).
## {% linkable_title Notes and Limitations %}
- Pairing is currently not supported
To setup the `apple_tv` platform, please follow the instructions on the [Apple TV Component page](/components/apple_tv/).