Inbetriebnahme und Grundkonfiguration von Roonmatrix und Coverplayer

Der Coverplayer unterstützt neben Roon auch Spotify sowie Apple Music.
Dabei gibt es einige Dinge zu beachten.

Beim ersten Start der Roonmatrix ist nur ein Nachrichtenticker (nbc news) vorkonfiguriert, damit man beim ersten Start direkt etwas angezeigt bekommt.
Das ist ganz praktisch, damit man beurteilen kann, ob das Gerät prinzipiell funktioniert. Hierfür holt sich die Roonmatrix den RSS-Feed aus dem Internet.
Ein Internetzugang wird also vorausgesetzt. Das heisst aber nicht automatisch, dass das Gerät aus dem Internet erreichbar ist. Das ist aus Sicherheitsgründen nicht so.
Es werden aber verschiedene Informationsquellen aus dem Internet angezapft, wie z.B. RSS-Feeds, oder ein optionaler Wetterdienst.
Von der eigenen Roonmatrix-Website www.roonmatrix.com holt sich das Gerät in regelmässigen Zeitabständen Updates der Sprachübersetzungen.
Vermisst du eine Übersetzung? Eigene Übersetzungen kann ich bei Bedarf gerne auf dem Server zur Verfügung stellen. 
Es handelt sich dabei um eine einfach strukturierte Datei im JSON-Format für die App, 
sowie im INI-Format für die Roonmatrix- und Coverplayer Hardware.

Hier ist ein Beispiel für eine json Datei (Übersetzung der App): translations_en.json

Und hier ist ein Beispiel für eine ini Datei (Übersetzung für RoonMatrix und Coverplayer): translations_es.ini

Die weitere Konfiguration hängt unter anderem von individuellen Voraussetzungen und Möglichkeiten, sowie Vorlieben ab.
Daher sind die meisten Funktionen erst einmal deaktiviert.
Die Konfiguration kann man aber sehr einfach mit der Roonmatrix App vornehmen. Diese ist auf allen wichtigen Plattformen  (MacOS, Windows, Linux, iOS, Android) verfügbar, 
Sie unterstützt ebenfalls den Coverplayer, und bietet dem Gerät entsprechende, angepasste Möglichkeiten zur Konfiguration und Steuerung.

Nun komme ich zu dem vermutlich wichtigsten Funktionsbereich der Geräte: Das anzeigen von Informationen der wichtigsten Musik- und Streaming Apps, sowie die Steuerung der Wiedergabe.

Roon:
Für Roon benötigt man neben der Roon Client App natürlich einen Roon Server im eigenen Netzwerk. Die IP und der Port des Servers werden automatisch erkannt. Hier ist also keine weitere Konfiguration notwendig.
Man muss zuerst den Zugriff auf Roon in der RoonMatrix App-Konfiguration freigeben. 

Beim ersten Start von RoonMatrix oder CoverPlayer muss man in der Roon Client App die Einstellungen aufrufen, dort dann den Bereich Erweiterungen öffnen, und hier die Erweiterung roonmatrix freigeben.

Das ist auch schon alles. Die Ausgabequellen - sogenannte Zones - werden automatisch erkannt.

Spotify Connect:
Für Spotify Connect benötigt man eine installierte Spotify Client App auf einem Desktop Computer deiner Wahl (MacOS, Windows, oder Ubuntu Linux), oder einem Smartphone deiner Wahl (iOS oder Android),
sowie einen Spotify Account. Ein kostenloser Account wird dabei nicht unterstützt, da dieser zu eingeschränkt ist (kein Spotify Connect Support, kein API Zugriff).
Ausserdem ist ein kostenloser Web-API Account notwendig. Diesen kann man über das Spotify Dashboard einrichten: https://developer.spotify.com/documentation/web-api
Wie gesagt, der Developer Account ist kostenlos, man muss ihn nur einmal einrichten.
Das Formular sieht in etwas so aus:

Die Spotify Web API Client id, sowie den API Secret Key aus der Anmeldung muss man dann noch in der Roonmatrix App Konfiguration entsprechend eintragen.

Jetzt wirst du dich eventuell fragen: Warum ist das notwendig, geht das nicht auch einfacher?
Nun, es handelt sich bei Roonmatrix und Coverplayer um freie, kostenlose Projekte. Die Software der Geräte ist frei, und kann von jedem gelesen und analysiert werden.
Da ist nichts verschlüsselt oder anderweitig geschützt. Ausserdem ist es von Anbietern wie Spotify oder Apple nicht gestattet, deren APIs anderen Benutzern frei zugänglich zu machen.
Die Zugangsdaten sind individuell, daher ist man als Anwender leider dazu gezwungen, sich selbst bei den Anbietern zu registrieren, um deren APIs zu nutzen. 
Du wirst dich vielleicht fragen, was das ist, eine API? Wozu brauche ich das?
Prinzipiell ist eine API eine Software-Schnittstelle welche man in einer eigenen Software verwenden kann, um eigene oder fremde Inhalte über verschiedene Funktionsaufrufe abfragen oder auch verändern zu können.
Spotify und Apple bieten solche APIs an, um auf deren Streaming-Musikbibliotheken zugreifen zu können. Unter anderem kann man damit Suchanfragen starten.
Ohne API-Zugriff ist daher auch keine Suche in deren Streaming-Musikbibliotheken möglich.

Bei Roon wird ebenfalls eine API verwendet, diese benötigt allerdings keine speziellen API-Zugangsdaten.
Das liegt sicherlich unter anderem daran, dass Roon ja lediglich deine eigenen Musikdaten mit Metadaten anreichert, und in einem Dienst zur Verfügung stellt, welcher in deinem eigenen Netzwerk liegt, und nicht im Internet.
Es ist 'deine' persönliche Musik, welche auf 'deinem' Server liegt. 

Zurück zu Spotify: Wenn der Spotify API Account in der Roonmatrix App Konfiguration eingerichtet ist, kann der Spotify Service mit Roonmatrix und Coverplayer verwendet werden.
Dann kannst du die Spotify Suchfunktion des Coverplayer nutzen, und Titel oder ganze Alben oder Playlisten auswählen und abspielen.
Das Cover und die Trackinformationen der ausgewählten Zone (Ausgangskanals) werden dann auf dem Coverplayer angezeigt.
Auf der Roonmatrix LED-Matrixanzeige werden dann die Informationen zum momentan abgespielten Titel auf dem Display angezeigt.
Die Roonmatrix kombiniert dabei alle Quellen zu einem Ausgabestream, so dass man alle Informationen zu den derzeit aktiven Zonen nacheinander angezeigt bekommt.
Das kann man dann bei Bedarf mit weiteren Quellen wie Wetterdaten oder RSS Feeds anreichern.

Wenn du Spotify Connect nutzen möchtest, dann musst du diese Funktion in der Roonmatrix App Konfiguration einschalten, und dich einmal mit dem Gerät bei Spotify Connect per Web anmelden.
Die Roonmatrix App unterstützt das: Wenn du Spotify Connect in der Konfiguration eingerichtet hast, aber noch nicht angemeldet bist, dann merkt die App das, und bietet dir in der Geräteübersicht einen Login-Button an.

Wenn du diesen einmal anklickst, dann wirst du innerhalb der App zum Web-Login weitergeleitet. Hier musst du deine Logindaten angeben.

Der Anmeldeprozess sieht dann in etwa so aus:

Hier ein Video eines Spotify Login via Roonmatrix App:

Hier ein Video eines Cached Login. Nach dem ersten Login wird das Passwort nicht mehr benötigt. Keine Ahnung wie das genau funktioniert, aber es funktioniert.

Bei erfolgreicher Authentifizierung wird das Anmeldetoken von der App an das Gerät übermittelt und auf dem Gerät gespeichert.
Danach musst du dich nicht mehr nach jedem Start des Gerätes einloggen, das passiert dann automatisch mit dem gespeicherten Token.
Wenn das alles soweit funktioniert hat, dann wird Spotify Connect ebenfalls im Roonmatrix Ausgabestream angezeigt, und auf dem Coverplayer wird nun auch ein Spotify Connect Button angezeigt. Das Coverplayer Menü rufst du auf, indem du das Touch-Displays berührst.
Durch einen klick auf den Spotify Connect Button im Coverplayer Menü kannst du ein Spotify Connect Streaming-Gerät auswählen. 

Der Spotify Connect Button ändert dann automatisch seinen Titel entsprechend dem Namen der ausgewählten Zone.
Typische Zonen (Ausgangskanäle) sind z.B. der Computer auf dem die Spotify App läuft, sowie Audio Streamer, welche Spotify Connect Support bieten. Darüber wiederum können Bluetooth Kopfhörer oder Lautsprecher angesteuert werden.

Der Coverplayer selbst bietet ebenfalls einen eingebauten Spotify Connect Server an. 
Du kannst an den Coverplayer oder Roonmatrix (optional) einen USB Bluetooth Audio Dongle wie z.B. von Avantree anschliessen.
Dieser zusätzliche Ausgabekanal kann dann direkt mit Spotify Connect verwendet werden, um daran die Musik von Spotify auf einen Bluetooth Kopfhörer zu hören.

Es gibt aber noch mehr Möglichkeiten: Airplay 2 wird auch unterstützt. Das bedeutet: Du kannst über den angeschlossenen BT Audio Dongle auch Musik mit der Apple Music App abspielen.

Auch Roon findet den BT Dongle als neuen Ausgabekanal. 

Den Möglichkeiten des BT Audio Dongles sind zur Zeit aber noch Grenzen gesetzt. Die Leistungsfähigkeit der in Roonmatrix und Coverplayer verbauten Raspberry Zero 2W Hardware gelangt damit an seine Grenzen.
Die Roonmatrix hat derzeit manchmal mit Aussetzern während der Wiedergabe zu kämpfen.
Beim Coverplayer sieht die Situation etwas besser aus. Mit diesem funktioniert die Wiedergabe in den meisten Fällen ohne Aussetzer.
Eventuell lässt sich die Software der Geräte dahingehend noch besser optimieren, so dass das in Zukunft zuverlässiger funktioniert.

Nun zum Apple Music Streaming Service:
Um diesen nutzen zu können, benötigt man ebenfalls einen API-Zugang.
Während dieser für Spotify kostenlos zu bekommen ist, muss man bei Apple einen Developer Account haben. Dieser kostet derzeit 99 Euro pro Jahr.
Wie man den API-Account einrichtet, seht ihr beispielhaft auf den nächsten Bildern.

Die Apple Music Web API team id, key id, und secret key muss man ebenfalls in der Roonmatrix App angeben, damit man die Suchfunktion des Coverplayer auch für Apple Music nutzen kann.

Für die Roonmatrix LED-Matrix ist die Apple Music Web API nicht notwendig, da man auf dem Gerät keine Suchfunktion hat.

Abgesehen von den Streaming Services kann man aber auch auf einem anderen Weg auf die eigenen Apple Music und Spotify Bibliotheken zugreifen.
Nämlich mit einem eigenen Webserver, welcher auf dem Computer laufen muss, auf dem auch Spotify und/oder die Apple Music App installiert ist.
Das muss allerdings ein Computer mit macOS sein, da der Webserver via PHP-Skript ein AppleScript steuert. 
Mit AppleScript lassen sich die Apps von Apple Music und Spotify komplett steuern und Musikinformationen abfragen.
Eine ähnliche Möglichkeit gibt es für Windows nach meinem Kenntnisstand leider nicht.

Wenn man bereits Spotify Connect eingerichtet hat, dann benötigt man den Webserver für die Steuerung von Spotify nicht.
Spotify Connect erlaubt nämlich ebenfalls die Suche in der Musikbibliothek, als auch die Steuerung der Wiedergabefunktionen sowie Ausgangskanäle. 

Bei Apple Music sieht das etwas anders aus: Für die Suche in der Musikbibliothek des Streamingangebots benötigt man den Web-API Account.
Aber darüber lässt sich nicht steuern, was abgespielt werden soll, und über welchen (Airplay 2) Ausgabekanal.
Letzteres geht nur leicht eingeschränkt via AppleScript über die Apple Music App, aber nicht über die API.
Leicht eingeschränkt bedeutet in diesem Fall folgendes: 
Die Steuerung der Wiedergabefunktionen macht manchmal Probleme, da es hierfür keine dedizierten  Steuerungsbefehle via AppleScript gibt, 
sondern nur die Möglichkeit der Navigation zum eigentlichen Play-Button durch Tastatur-Steuerbefehle. Und das ist heikel, da das nicht immer zu 100% funktioniert. 
Manchmal reicht die Wiederholung der Musikauswahl am Coverplayer, damit es dann funktioniert.
Während die Suche im Streaming-Angebot via Web-API funktioniert, ist die Suche in der eigenen lokalen Musikbibliothek (welche auf dem eigenen Rechner liegt) nur über AppleScript möglich.
Auch die Steuerung der Wiedergabefunktionen für eigene Inhalte geht nur über AppleScript, in diesem Fall aber ohne Probleme.

Für die Steuerung von Spotify (nicht Spotify Connect) und Apple Music benötigt man zwingend einen Apple Computer mit eingerichtetem Webserver und einigen Rechteeinstellungen.
Das ist für den einfachen Benutzer ohne tiefgreifende Kenntnisse in diesen Bereichen nicht ganz so einfach, aber durchaus möglich.
Es wird recht ausführlich und hoffentlich gut verständlich in diesem Beitrag erklärt: Coverplayer Teil 3: Lokaler Webserver für Apple Music und Spotify.

Ich hoffe ich konnte durch diesen Artikel ein paar Unklarheiten zum Thema Einrichtung der Geräte beseitigen.
Falls es offene Fragen hierzu gibt, würde ich mich freuen, wenn du dazu das Forum auf meiner Website nutzt, oder mich direkt kontaktierst.
Ebenso wäre ich erfreut über Hinweise zu Fehlern, egal ob es die Hardware, Software, oder Website betrifft. 
Auch weitere Anregungen zu Verbesserungen, neuen Features, oder Änderungswünsche sind herzlich willkommen.
Ganz toll wäre auch ein kurzes Statement ob der Nachbau funktioniert hat, welche Schwierigkeiten es eventuell gab, oder ob es an irgendeiner Stelle noch klärender Worte bedarf.

Ich wünsche auf jeden Fall gutes Gelingen bei Aufbau und Betrieb dieser hoffentlich für dich recht nützlichen Geräte.