This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# MPD Binding
Music Player Daemon (MPD) (opens new window) is a flexible, powerful, server-side application for playing music. Through plugins and libraries it can play a variety of sound files while being controlled by its network protocol.
With the openHAB MPD binding you can control Music Player Daemons.
# Supported Things
This binding supports one ThingType: mpd
# Discovery
If zeroconf is enabled in the Music Player Daemon, it is discovered. Each Music Player daemon requires a unique zeroconf_name for correct discovery.
# Thing Configuration
The ThingType mpd requires the following configuration parameters:
Parameter Label | Parameter ID | Description | Required |
---|---|---|---|
IP Address | ipAddress | Host name or IP address of the Music Player Daemon | yes |
Port | port | Port number on which the Music Player Daemon is listening. Default: 6600 | yes |
Password | password | Password to access the Music Player Daemon | no |
# Channels
The following channels are currently available:
Channel Type ID | Item Type | Description |
---|---|---|
control | Player | Start/Pause/Next/Previous |
volume | Dimmer | Volume in percent |
stop | Switch | Stop playback |
currentalbum | String | Current album |
currentartist | String | Current artist |
currentname | String | Current name |
currentsong | Number | Current song |
currentsongid | Number | Current song id |
currenttitle | String | Current title |
currenttrack | Number | Current track |
# Full Example
# Thing
mpd:mpd:music [ ipAddress="192.168.1.2", port=6600 ]
# Items
Switch morning_music "Morning music"
Player mpd_music_player "Player" { channel = "mpd:mpd:music:control" }
Dimmer mpd_music_volume "Volume [%d %%]" { channel = "mpd:mpd:music:volume" }
Switch mpd_music_stop "Stop" { channel = "mpd:mpd:music:stop" }
String mpd_music_album "Album [%s]" { channel = "mpd:mpd:music:currentalbum" }
String mpd_music_artist "Artist [%s]" { channel = "mpd:mpd:music:currentartist" }
String mpd_music_name "Name [%s]" { channel = "mpd:mpd:music:currentname" }
Number mpd_music_song "Song [%d]" { channel = "mpd:mpd:music:currentsong" }
Number mpd_music_song_id "Song Id [%d]" { channel = "mpd:mpd:music:currentsongid" }
String mpd_music_title "Title [%s]" { channel = "mpd:mpd:music:currenttitle" }
Number mpd_music_track "Track [%d]" { channel = "mpd:mpd:music:currenttrack" }
# Sitemap
Frame label="Music" {
Default item=mpd_music_player
Slider item=mpd_music_volume
Switch item=mpd_music_stop
Text item=mpd_music_album
Text item=mpd_music_artist
Text item=mpd_music_name
Text item=mpd_music_song
Text item=mpd_music_song_id
Text item=mpd_music_title
Text item=mpd_music_track
}
# Rule
rule "turn on morning music"
when
Item morning_music changed to ON
then
val actions = getActions("mpd","mpd:mpd:music")
if(actions === null) {
logWarn("myLog", "actions is null")
return
}
actions.sendCommand("clear")
actions.sendCommand("load", "MorningMusic");
actions.sendCommand("shuffle");
actions.sendCommand("play");
end
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)