MPD

MPD
Zweck / Funktion
	FHEM Modul zur Steuerung des Music Player Daemons
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE; Thema
Support (Forum)	Multimedia
Modulname	73_MPD.pm
Ersteller	Wzut (Forum /Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

FHEM Modul zur Steuerung des MPD (oder Mopidy) ähnlich dem MPC (MPC = Music Player Command, das Kommandozeilen-Interface für den Music Player Daemon ).

Voraussetzungen

FHEM-Server

Um das Modul MPD benutzen zu können, sind folgende Voraussetzungen zu erfüllen:

Das Modul benötigt zwingend JSON, installation z.B. mit

sudo apt-get install libjson-perl

Installiertes Perl-Modul XML:Simple

Die Installation erfolgt mittels

sudo apt-get install libxml-simple-perl

oder

cpan install XML:Simple

MPD

Um den MPD auf einem Raspberry Pi zu installieren finden sich im Internet zahlreiche gute Dokumentaionen z.B. hier sowie im Forenthema Modul für MPD.

Falls jemand eine höhere Version benötigt als diejenige, die in der Paketverwaltung angeboten wird, findet sich hier eine englische Anleitung zum Selbst-Kompilieren.

Installation

MPD-Device in FHEM

Syntax

define <name> MPD <IP MPD Server | default localhost> <Port MPD Server | default 6600>

Beispiel

define myMPD MPD 192.168.0.99 7000

Wenn FHEM und der MPD auf dem gleichen Server laufen:

define myMPD MPD

Anwendung

Attribute

password

Password falls in der mpd.conf definiert

loadMusic 1|0

lade die MPD Titel beim FHEM Start : mpd.conf - music_directory

loadPlaylists 1|0

lade die MPD Playlisten beim FHEM Start : mpd.conf - playlist_directory

volumeStep x

Schrittweite für Volume +/-

titleSplit 1|0

zerlegt die aktuelle Titelangabe am ersten Vorkommen von - (BlankMinusBlank) in die zwei Felder Artist und Titel, wenn im abgespielten Titel die Interpreten Information nicht verfügbar ist (sehr oft bei Radio-Streams default 1). Liegen keine Titelangaben vor wird die Ausgabe durch den Namen der Radiostation ersetzt

timeout (default 1)

Timeoutwert in Sekunden für die Verbindung fhem-mpd waits (default 60)

Überwachungszeit in Sekunden für den Idle Prozess. In Verbindung mit refresh_song der Aktualisierungs Intervall für die aktuellen Songparamter, (z.B. um den Fortschrittsbalken bei TabletUI aktuell zu halten)

stateMusic 1|0

zeige Musikliste als DropDown im Webfrontend

statePlaylists 1|0

zeige Playlisten als DropDown im Webfrontend

player mpd|mopidy|forked-daapd (default mpd)

welcher Player wird gesteuert ACHTUNG : Mopidy unterstützt nicht alle Kommandos des echten MPD ! (siehe Mopidy Dokumentation) Cover Art Funktionen von last.fm :

image_size -1|0|1|2|3 (default -1 = keine Interpretenbilder und Infos von last.fm verwenden)

last.fm stellt verschiedene Bildgroessen zur Verfügung :

0 = 32x32 , 1 = 64x64 , 2 = 174x174 , 3 = 300x300

artist_content 0|1

stellt Interpreteninformation im Reading artist_content zur Verfügung

artist_summary 0|1

stellt weitere Interpreteninformation im Reading artist_summary zur Verfügung

Beispiel Anzeige mittels readingsGroup :

define rg_artist readingsGroup <MPD name>:artist,artist_image_html,artist_summary

attr rg_artist room MPD

cache

(default lfm /fhem/www/lfm) Zwischenspeicher für die JSON und PNG Dateien

Wichtig : Der User unter dem der fhem Prozess ausgeführt wird (default fhem) muss Lese und Schreibrechte in diesem Verzeichniss haben! Das Verzeichnis sollte auch unterhalb von www liegen, damit der fhem Webserver direkten Zugriff auf die Bilder hat.

unknown_artist_image

Ersatzimage wenn kein anderes Image zur Verfügung steht (default : /fhem/icons/1px-spacer)

bookmarkDir

ein vom FHEM User les- und beschreibbares Verzeichnis. Wennn dieses definiert wird, ist das Speichern und Wiederherstellen von Playlistzuständen mit Hilfe von set/get bookmark möglich

autoBookmark

wenn dies auf 1 gesetzt wird, dann werden automatisch Playlistenzustände geladen und gespeichert, immer wenn die Playliste mit diesem Modul gewechselt wird

seekStep

wenn definiert, wird dadurch die Sprungweite von forward und rewind gesetzt. Der Wert gilt als Prozentwert. default: 7

seekStepSmall

Wenn diesem Attribut kann für den Anfang eines Tracks innerhalb der ersten per seekStepSmall definierten Prozent eine kleinere Sprungweite definiert werden, um so z.B. die Intromusik von Hörspielen oder Hörbüchern überspringen zu können. default: 1

seekStepSmallThreshold

unterhalb dieses Wertes wird seekStepSmall benutzt, oberhalb seekStep default: 0 (ohne Funktion)

no_playlistcollection (default 0)

wenn auf 1 gesetzt wird das Reading playlistcollection nicht erzeugt

Set

set <name> <was>

z.Z. unterstützte Kommandos

play

spielt den aktuellen Titel der MPD internen Playliste

clear

löscht die MPD interne Playliste

stop

stoppt die Wiedergabe

pause

Pause an/aus

previous

spielt den vorherigen Titel in der Playliste

next

spielt den nächsten Titel in der Playliste

random

zufällige Wiedergabe an/aus

repeat

Wiederholung an/aus

toggle

wechselt von play nach stop bzw. stop/pause nach play

volume (%)

ändert die Lautstärke von 0 - 100%

volumeUp

Lautstärke schrittweise erhöhen , Schrittweite = ( attr volumeStep size )

volumeDown

Lautstärke schrittweise erniedrigen , Schrittweite = ( attr volumeStep size )

playlist (name|SongNr|Position)

lade Playliste aus der MPD Datenbank und starte die Wiedergabe. Werden SongNr und/oder Position nicht mit übergeben, startet die Wiedergabe mit dem ersten Titel (Song=0) am Anfang (Position=0)

playfile (file)

erzeugt eine MPD interne Playliste mit file als Inhalt und spielt dieses ab

updateDb

wie MPC update, Update der MPD Datenbank

reset

reset des FHEM MPD Moduls

mpdCMD (cmd)

sende cmd direkt zum MPD Server ( siehe auch MPD Comm Ref )

IdleNow

sendet das Kommando idle zum MPD und wartet auf Ereignisse

clear_readings

löscht sehr viele Readings

mute

on,off,toggle

seekcur (zeit)

Format: [[hh:]mm:]ss. nicht vor MPD Version 0.20

forward

Springt im laufenden Track um einen optional per seekStep oder seekStepSmall definierten Wert nach vorne bzw. defaultmäßig um 7%.

rewind

Springt so wie bei forward beschrieben entsprechend zurück.

channel

Wechsele zur Playliste mit der angegebenen Nummer

channelUp

wechselt zur nächsten Playliste

channelDown

wechselt zur vorherigen Playliste

save_bookmark

speichert den aktuellen Zustand (Tracknummer und Position innerhalb des Tracks für die gerade geladene Playliste. Dies funktioniert nur, wenn die Playliste mit dem Modul geladen wurde und wenn das Attribut bookmarkDir gesetzt ist.

load_bookmark

stellt den zuletzt gespeicherten Zustand (set bookmark) der geladenen Playliste wieder her und springt zum gespeicherten Track und Position wird zusätzlich mit übergeben wird zuvor die entsprechend Playliste geladen

Get

get <name> <was>

z.Z. unterstützte Kommandos

music

zeigt alle Dateien der MPD Datenbank

playlists

zeigt alle Playlisten der MPD Datenbank

playlistsinfo

zeigt Informationen der aktuellen Playliste

webrc

HTML Ausgabe einer einfachen Web Fernbedienung Bsp :.

define <name> weblink htmlCode {fhem("get <name> webrc", 1)}

attr <name> room MPD

statusRequest

hole aktuellen MPD Status

currentsong

zeigt Informationen zum aktuellen Titel der MPD internen Playliste

outputs

zeigt Informationen der definierten MPD Ausgabe Kanäle ( aus /etc/mpd.conf )

bookmarks

zeigt eine Liste aller bisher gespeicherten Bookmarks

Readings

alle MPD internen Werte sowie vom Modul direkt erzeugte Readings:

playlistinfo: (TabletUI Medialist)
playlistcollection: (TabletUI)
playlistname: (TabletUI)
artist_image: (bei Nutzung von Last.fm)
artist_image_html: (bei Nutzung von Last.fm)
album_image: (bei Nutzung von Last.fm)
album_image_html: (bei Nutzung von Last.fm)
artist_content: (bei Nutzung von Last.fm)
artist_summary: (bei Nutzung von Last.fm)
playlistinfo: (z.B. für die TabletUI Medialist)
playlistcollection: (TabletUI) Liste der Playlisten
playlistname: (TabletUI) Name der aktuellen Playliste aus playlistcollection
playlist_num: Playlisten Nr. (0 .. n) der aktuellen Playliste aus playlistcollection playlist_json : (notwendig fü das Medialist Modul)
Cover: Cover Bild zum aktuellen Song aus playlist_json
currentTrackProvider: Radio / Bibliothek - Unterscheidung Radio Stream oder lokale Datei
rawTitle: Title Information ohne Veränderungen durch das Modul

Anwendungsbeispiele

Den eigenen Radiosender steuern

Früher schleppte man das Notebook ins Wohnzimmer, schloss es an die Stereoanlage an und spielte mittels Programm auf dem Notebook die Musik von der heimischen Festplatte ab.

Hat man die Musik auf einem Server oder NAS liegen, bietet sich ein Internetradio im Wohnzimmer mit einem eigenen Internet-Radiosender als Alternative an. Fehlt nur noch die passende Fernbedienung. Die Music Player Daemon-Software wird auf dem Server oder einem Raspi installiert und durchsucht nach passender Konfiguration die Festplatte nach Musik. Einmal in einer Datenbank inventarisiert, können mittels MPD-Client Playlisten zusammengestellt und abgelegt werden.

Mit dem MPD-Modul kann FHEM die Kontrolle übernehmen. Dies betrifft den Wechsel der Playlisten, als auch das Überspringen von Titeln sowie die Lautstärkeregelung.

Links