MediaList

MediaList
Zweck / Funktion
Erstellt eine Playliste aus lokaler Musiksammlung
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Support (Forum)	Automatisierung
Modulname	98_MediaList.pm
Ersteller	tobiasfaust (Forum /Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Einleitung

Das MediaList-Modul ist ein Hilfsmodul für eine SONOS- oder MPD-Musiksteuerung. Das Modul erstellt auf Grundlage einer lokalen Mediathek (zb. von einem NAS per Samba auf dem FHEM Server eingebunden) eine Playlist. Der Benutzer wird dadurch durch eine Menüstruktur geleitet. Es kann ebenso per One-Click für das aktuelle Verzeichnis automatisch eine Playlist erstellt werden.

Weiterhin wird entweder ein lokal vorhandenes Cover oder ein Cover im Internet gesucht. Die Readings der MediaList sind an das TabletUI Widget "MediaList" angepasst.

Features

• Navigation durch eine lokal angebundene Musikbibliothek
• Erstellung von Playlisten in einer TabletUI-MediaList Widget JSON Struktur
• One-Click für eine Playlist des aktuell gewählten Verzeichnisses
• Suchen eines passenden Album Covers aus vier verschiedenen Internet-Quellen
• Übergabe der Playlist an ein SONOS- oder MPD-Device

Voraussetzungen

Es müssen ein paar PerlModule installiert sein:

install package libmp3-tag-perl, libjson-xs-perl, libmp3-info-perl, libmath-round-perl

Definition in FHEM

TabletUI-Ansicht

Erstellung einer Playlist

So wird das Modul definiert:

define <MyMediaList> MediaList <StartPfad>

define MyMediaList MediaList /media/music/

Folgende Attribute sollten gesetzt sein

• MediaList_PathReplaceFrom: Der lokal eingemountete Pfad
• MediaList_PathReplaceTo: die UNC Samba Freigabe im lokalen LAN (ohne Passwort(!)) für die mp3 Dateien
• MediaList_PathReplaceToPic: Ein öffentlicher im lokalen LAN zugänglicher Pfad, per Apache oder FHEM freigegeben
• MediaList_PlayerDevice: Das Zieldevice, welches die Playlist abspielen kann, aktuell nur SONOS und MPD
• MediaList_PlayerStartCommand: Das Startkommando für das Zieldevice. Platzhalter <???> werden beim Start durch den Pfad der generierten m3u-Datei ersetzt

Folgende Platzhalter werden im Attribut "MediaList_PlayerStartCommand" akzeptiert

• <fullfile> -> der volle Dateipfad mit Dateiname und Dateiendung
• <filename> -> nur der Dateiname, ohne Endung
• <fileext> -> nur die Dateiendung

Beispieldefinition für ein Sonos Player

MediaList_PathReplaceFrom /media/music/
MediaList_PathReplaceTo \\NAS/music/
MediaList_PathReplaceToPic https://192.168.10.30/music/
MediaList_PlayerDevice sonos_Wohnzimmer
MediaList_PlayerStartCommand StartPlaylist file:<fullfile> 
MediaList_mkTempCopy none

Durch die Angabe des PlayerStartCommand wird die Playliste automatisch dem Sonos übergeben und angestartet.

set <MediaList> Play 

Beispieldefinition für ein MPD Player

FHEM Konfiguration

MediaList_CacheFileDir /var/lib/mpd/playlists/
MediaList_PathReplaceFrom /media/music/
MediaList_PathReplaceToPic https://192.168.10.30/music/
MediaList_PlayerDevice MPD_KiZi
MediaList_mkTempCopy symlink

Der Name der Playlist ist immer <PlayerDevice>.m3u. Die Plalist kann man nun in den MPD einladen und starten mit folgenden Kommando

set <PlayerDevice> playlist <PlayerDevice>

Zur Beachtung: den playlistnamen ohne die m3u Endung zu übergeben!

MPD Konfiguration

In der mpd.conf muss folgendes aktiviert sein:

auto_update "yes"
save_absolute_paths_in_playlists "no"
follow_outside_symlinks "yes"
filesystem_charset "UTF-8"

In der mpd.conf muss das Musik-Verzeichnis und das PlaylistVerzeichnis identisch sein.

Links

• InitialThread