home-assistant.github.io/source/components/media_player.itunes.markdown
2015-09-14 21:20:31 -04:00

1.4 KiB

layout title description date sidebar comments sharing footer
page iTunes support Instructions how to integrate iTunes into Home Assistant. 2015-06-22 11:00 false false true 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. Play, pause, or skip songs remotely on iTunes running on your Mac.

Your AirPlay speakers will also be exposed as simple media players inside Home Assistant. They will be available to be turned on or off or set their volume.

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.