Apple iTunes

The itunes media player platform allows you to control iTunes from Home Assistant. It uses a 3rd party server that you run on your Mac called itunes-api. Play, pause or skip songs remotely on iTunes running on your Mac.

In addition to controlling iTunes, your available AirPlay endpoints will be added as media players as well. You can then individually address them and turn them on, turn them off or adjust their volume.


To add iTunes to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: itunes

Configuration Variables

host string Required

The IP of the itunes-api API, e.g.,

port integer (Optional, default: 8181)

The port where itunes-api is accessible, e.g., 8181.