2.2 KiB

title description ha_category ha_release ha_iot_class ha_domain ha_platforms ha_integration_type
Music Player Daemon (MPD) Instructions on how to integrate Music Player Daemon into Home Assistant.
Media Player
pre 0.7 Local Polling mpd
media_player
integration

The mpd platform allows you to control a Music Player Daemon from Home Assistant. Unfortunately you will not be able to manipulate the playlist (add or delete songs) or add transitions between the songs.

Even though no playlist manipulation is possible, it is possible to use the play_media service to load an existing saved playlist as part of an automation or scene.

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

# Example configuration.yaml entry
media_player:
  - platform: mpd
    host: IP_ADDRESS

{% configuration %} host: description: Hostname or IP address of the Host where Music Player Daemon is running. required: true type: string port: description: Port of the Music Player Daemon. required: false type: integer default: 6600 name: description: Name of your Music Player Daemon. required: false type: string default: MPD password: description: Password for your Music Player Daemon. required: false type: string {% endconfiguration %}

Example script to load a saved playlist called "DeckMusic" and set the volume:

relaxdeck:
    sequence:
    - service: media_player.play_media
      target:
        entity_id: media_player.main
      data:
        media_content_type: playlist
        media_content_id: DeckMusic

    - service: media_player.volume_set
      target:
        entity_id: media_player.main
      data:
        volume_level: 0.60

This platform works with Music Player Daemon and mopidy with Mopidy-MPD as used by Pi MusicBox. While all of these rely on the common MPD protocol, not all implementations support all features, especially with regard to album artwork, embedded artwork and volume control. The platform will fall back gracefully if support isn't detected.