Apple iTunes


The itunes media player integrationIntegrations connect and integrate Home Assistant with your devices, services, and more.
[Learn more]
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.

Configuration

To add iTunes to your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI.
[Learn more]
file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI.
[Learn more]
file, restart Home Assistant to apply the changes. To view the changes, go to Settings > Devices & services > Entities.

# Example configuration.yaml entry
media_player:
  - platform: itunes
    host: 192.168.1.50

Configuration Variables

host string Required

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

port integer (Optional, default: 8181)

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