From 9dfe758f3f555274f1f12cfbb79e259e0fc6ca3a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pierre=20St=C3=A5hl?= Date: Wed, 8 Feb 2017 18:33:54 +0100 Subject: [PATCH] Add documentation for Apple TV (#1996) --- .../media_player.apple_tv.markdown | 60 ++++++++++++++++++ source/images/supported_brands/apple.png | Bin 0 -> 3576 bytes 2 files changed, 60 insertions(+) create mode 100644 source/_components/media_player.apple_tv.markdown create mode 100644 source/images/supported_brands/apple.png diff --git a/source/_components/media_player.apple_tv.markdown b/source/_components/media_player.apple_tv.markdown new file mode 100644 index 00000000000..9abdbdfe359 --- /dev/null +++ b/source/_components/media_player.apple_tv.markdown @@ -0,0 +1,60 @@ +--- +layout: page +title: "Apple TV" +description: "Instructions how to integrate Apple TV devices into Home Assistant." +date: 2017-02-08 07:11 +sidebar: true +comments: false +sharing: true +footer: true +logo: apple.png +ha_category: Media Player +ha_iot_class: "Local Polling" +ha_release: 0.38 +--- + +The `apple_tv` platform allows you to control an Apple TV (3rd and 4th generation). + +

+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 released. +

+ +## {% linkable_title Configuration %} + +If you want to automatically discover new devices, just make sure you have ``discovery:``in +your ``configuration.yaml``. To manually add an Apple TV to your installation, add the following +to your configuration file: + +```yaml +# Example configuration.yaml entry +media_player: + - platform: apple_tv + host: IP_ADDRESS + login_id: LOGIN_ID + name: NAME +``` + +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. Just run it like this to scan for all devices (try again if a device +is missing): + +``` +$ 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). + +## Notes and Limitations + +- Pairing is currently not supported diff --git a/source/images/supported_brands/apple.png b/source/images/supported_brands/apple.png new file mode 100644 index 0000000000000000000000000000000000000000..37af65d5fedd8292c8c3bdee8c467d35950c5e1d GIT binary patch literal 3576 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 lR8zd*aFrYKpeZ-(gLjAa?PF;ZHk_{