mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 15:56:49 +00:00
530204bb23
* m-o integrations: apply sentence-style caps to categories * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Apply suggestions from code review Co-authored-by: Joakim Sørensen <joasoe@gmail.com> * Apply suggestions from code review Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com> --------- Co-authored-by: Joakim Sørensen <joasoe@gmail.com> Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
---
|
|
title: Music Player Daemon (MPD)
|
|
description: Instructions on how to integrate Music Player Daemon into Home Assistant.
|
|
ha_category:
|
|
- Media player
|
|
ha_release: pre 0.7
|
|
ha_iot_class: Local Polling
|
|
ha_domain: mpd
|
|
ha_platforms:
|
|
- media_player
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
The `mpd` platform allows you to control a [Music Player Daemon](https://www.musicpd.org/) 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:
|
|
|
|
```yaml
|
|
# 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:
|
|
|
|
```yaml
|
|
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](https://www.musicpd.org/) and [mopidy](https://www.mopidy.com/) with [Mopidy-MPD](https://mopidy.com/ext/mpd/) as used by [Pi MusicBox](https://www.pimusicbox.com/). 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.
|