diff --git a/source/components/media_player.itunes.markdown b/source/components/media_player.itunes.markdown new file mode 100644 index 00000000000..374d1c962b2 --- /dev/null +++ b/source/components/media_player.itunes.markdown @@ -0,0 +1,37 @@ +--- +layout: page +title: "iTunes support" +description: "Instructions how to integrate iTunes into Home Assistant." +date: 2015-06-22 11:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +The iTunes platform allows you to control [iTunes](http://apple.com/itunes/) via [itunes-api](https://github.com/maddox/itunes-api) from Home Assistant. + +

+iTunes itself can not be remotely controlled. In order to control your iTunes, +you'll need to install middleware named `itunes-api`. `itunes-api` is a simple REST +server that talks to a local instance of iTunes via Applescript. It's very easy to set up +and run. You can find more about it on it's [GitHub repo](https://github.com/maddox/itunes-api). +

+ + +To add iTunes to your installation, add the following to your `configuration.yaml` file: + +``` +# Example configuration.yaml entry +media_player: + platform: itunes + name: iTunes + host: http://192.168.1.50 + port: 8181 +``` + +Configuration variables: + +- **host** *Required*: The URL of the itunes-api API, eg. http://192.168.1.50 +- **port** *Optional*: The PORT that itunes-api is running on.