SqueezeboxRPC: Controller für Logitech Media Server über RPC-Protokoll

Dies ist ein alternativer Adapter, der Folgendes verwendet:JSON/RPC -Protokoll zum Abrufen von Daten und Senden von Befehlen an den Logitech Media Server/Lyrion Media Server ( LMS ) zur Steuerung angeschlossener Geräte wie

• native squeezebox ,
• Raspberry Pi mit zusätzlichem Audiomodul und kleinen Linux-basierten Firmwares wie Picoreplayer oder Max2Play .
• WiiM Multiroom-Audio ( kann mit einem LMS/Lyrion-Server kommunizieren )
• mit Chromecast-, AirPlay- oder PluginsUPnP/DLNA -Geräte

DerLMS -Der Server kann sehr große Musiksammlungen auf Festplatten verwalten/bereitstellen oderNAS , Verbindung zu verschiedenen Streaming-Anbietern herstellen wieSpotify ,Deezer ,Soundcloud ,shoutcast ,tunein ,napster ,pandora ,tidal und mehr

Inhaltsverzeichnis

• Installation
  • Server
• Widgets
  • VIS 1 Widget-Dokumentation
  • VIS 2 Widget-Dokumentation
• Todo
• Änderungsprotokoll
• Lizenz

Merkmale

• die meisten Daten , die dieLMS Der Dienst ist im Adapter verfügbar.
• Detaillierte Informationen zum Abspielstatus, Songtitel, Interpret, Album, Cover und zur Playlist
• viele Steuerungsfunktionen zum Abspielen, Pausieren, Stoppen, Vorspulen,
  Zurückspulen, Wiederholen, Zufallswiedergabe, Favoriten abspielen, zu einer bestimmten Zeit springen
  (absolut und relativ), zum Wiedergabelistenindex springen (absolut und relativ),
  Ein-/Ausschalter und Voreinstellungstasten
• Alle Favoriten und alle Unterebenen vom Server
• Viele Widgets für die iobroker-vis-Komponente sind enthalten.
  Eigene Steuerungsschnittstellen erstellen (Player auswählen, Favoriten auswählen, Synchronisierungsgruppen verwalten, Schaltflächen für Wiedergabe/Pause, Vorwärts, Rückwärts, Wiederholungsmodus und Zufallswiedergabemodus auswählen)

Installation

• Installieren Sie das Paket
• Erstellen Sie eine Instanz
• Konfigurieren Sie die Instanz mit der IP-Adresse des Logitech/Lyrion-Medienservers und dem Port (normalerweise 9000).
• Instanz starten/neu starten

Konfiguration

Haupteinstellungen

Der WebSocket-Modus erfordert das experimentelle LMS-WebSocket-Plugin . Er überträgt Befehle und Benachrichtigungen über dieselbe Verbindung, daher werden die Telnet-Einstellungen in diesem Modus ignoriert. Die reguläre Player-Abfrage bleibt als Fallback für fehlende oder unvollständige Benachrichtigungen aktiviert. HTTP(S)-WebSocket-URLs werden in WS(S)-URLs konvertiert./ws wird automatisch hinzugefügt, wenn nur eine Stamm-URL konfiguriert ist.

Timer-Einstellungen

Kurze Aktualisierungsintervalle erhöhen die Anzahl der an das LMS gesendeten Anfragen.

Leistungseinstellungen

Deaktivieren Sie nicht benötigte Informationen, um die LMS-Anfragen und die Adapterverarbeitung zu reduzieren.

Ankündigungseinstellungen

Für lokale Ansagedateien muss das LMS die konfigurierte ioBroker-Web-URL erreichen können. HTTP(S)-Ansage-URLs werden direkt an das LMS übermittelt und benötigen diese Einstellung nicht. FadeTools-Befehle werden nur gesendet, wenn die Option aktiviert ist. Ohne FadeTools werden alle Lautstärkewerte direkt festgelegt und mit dem LMS abgeglichen.

Debug-Einstellungen

Debug-Protokollierung und insbesondere unnötige Protokollierung sollten normalerweise deaktiviert bleiben und nur zur Diagnose eines Problems aktiviert werden.

Aktualisieren

• Nach der Installation oder Aktualisierung kann es manchmal erforderlich sein
  Führen Sie den folgenden Befehl aus, falls in vis-1 Probleme aufgetreten sind.

iobroker upload squeezeboxrpc

Fehlerbehebung

SLIMP3-Spieler

Es wurde berichtet, dass ältere SLIMP3-Player möglicherweise keine Verbindung zum Server herstellen können, während der Adapter nach neuen Servern sucht. Durch Deaktivieren der Suche unter „Instanzkonfiguration → Leistungseinstellungen → Suche nach anderen LMS-Servern“ sollte die Verbindung des Players wiederhergestellt werden.

Bereitgestellte Staaten

Server

zusätzlich eine definierte Schaltfläche zum Aktualisieren der Favoriten

Favoriten

Für jeden Favoriten sind alle Attribute schreibgeschützt.

Alle Unterebenen (Unterverzeichnisse) von Favoriten sind verfügbar.

Spieler

Für jeden Spieler zeigt der Modus an, ob der Wert geändert werden kann. Die durchgeführte Aktion wird im Attribut beschrieben.

Die Wiedergabeliste bietet, sofern verfügbar, die folgenden Attribute:LMS Einige Attribute hängen vom Typ der Songs ab (Stream/Datei/...). Alle Attribute sind schreibgeschützt.

zusätzlich definierte Schaltflächen:

Die Ansageeinstellungen definieren die Lautstärke und die optionale Integration mit dem LMS FadeTools-Plugin . Wenn diese Option aktiviert ist, sendet der Adapter …fadeout stop wartet die konfigurierte Ausblenddauer ab und setzt die Wiedergabe später fort.fadein play Wenn diese Option deaktiviert ist, werden die vorherigen und die Ankündigungsvolumes direkt festgelegt. Für lokale Dateien müssen Sie die Basis-URL einer ioBroker-Webinstanz konfigurieren (z. B.http://192.168.1.10:8082 Der LMS-Host muss diese URL erreichen können. Remote-Streams werden ohne Suchfunktion wiederhergestellt, da sie in der Regel keine Wiedergabeposition unterstützen.

Anmerkungen zu Datenpunkten in Abhängigkeit von der Einstellung TPE2 im LMS

Je nach Einstellung werden den Datenpunkten unterschiedliche MP3-Tags zugewiesen. Die großgeschriebenen Namen sind die Namen der MP3-Tags.

Es ist außerdem zu beachten, dass nach einer Änderung des Lernmanagementsystems die gesamte Bibliothek umgestellt werden muss.
erneut gesucht und indexiert werden, und ein Lied muss angehalten und neu gestartet werden.
bevor das LMS andere Daten liefert.

Weitere API-Dokumentation

Weitere Informationen finden Sie in der CLI-Dokumentation:

https://github.com/oweitman/LMS-CLI-Documentation/blob/master/LMS-CLI.md

Widgets

Der Adapter enthält passende Widget-Sets für beide Visualisierungsgenerationen. Jede Widget-Referenz enthält ihren Zweck, ein Vorschaubild, alle codebasierten Konfigurationsoptionen und relevante Laufzeithinweise:

• Vollständige VIS 1-Widget-Dokumentation
• Vollständige VIS 2-Widget-Dokumentation

Beide Widget-Sets verwenden ein Player- Widget als zentrale Auswahlquelle. Konfigurieren Sie dieses Widget zuerst und wählen Sie es anschließend in Steuerelementen, Wertanzeigen, Favoriten, Wiedergabelisten, Wiedergabelistendetails, Browser und Synchronisierungsgruppen aus. VIS 2-Referenzen funktionieren in verschiedenen Ansichten.

.plentry {
    border: 1px #505050 groove;
    margin: 1px 0px;
    padding: 5px;
    background-color: #202020;
}
.plrefresh {
    padding: 5px;
}
.plentry:hover {
    background-color: #404040;
}
.plrefresh svg {
    color: #cccccc;
}
.plrefresh svg:hover {
    color: #ffffff;
    filter: drop-shadow(0px 0px 1px #87ceeb);
}

.plentry {
    border: 1px #b0b0b0 groove;
    margin: 1px 0px;
    padding: 5px;
    background-color: #c0c0c0;
}
.plrefresh {
    padding: 5px;
}
.plentry:hover {
    background-color: #e0e0e0;
}
.plrefresh svg {
    color: #444444;
}
.plrefresh svg:hover {
    color: #000000;
    filter: drop-shadow(0px 0px 1px #87ceeb);
}

SendTo-Befehle

Spielernamen abrufen

Gibt die Namen aller aktuell im Adapter registrierten Spieler zurück. Die zurückgegebenen Namen sind die unten verwendeten, bereinigten Namen.squeezeboxrpc.<instance>.Players Die

async function main() {
    const playerNames = await sendToAsync('squeezeboxrpc.0', 'getPlayerNames', {});
    console.log(JSON.stringify(playerNames));
}
main();

Beispielergebnis:

["Living_room", "Kitchen"]

cmdGeneral

Mit diesem Befehl können Sie beliebige Befehle an den LMS-Server senden und eine Antwort erhalten.

Beispiel:

Alle Wiedergabelisten:

async function main() {
    let data = await sendToAsync('squeezeboxrpc.0', 'cmdGeneral', {
        playerid: '',
        cmdArray: ['playlists', '0', '999', 'tags:us'],
    });
    console.log(JSON.stringify(data));
}
main();

Alle Favoriten:

Dieser Befehl wird intern vom Adapter verwendet, um die Favoriten zu laden.

async function main() {
    let data = await sendToAsync('squeezeboxrpc.0', 'cmdGeneral', {
        playerid: '',
        cmdArray: ['favorites', 'items', '0', '999', 'want_url:1', 'item_id:'],
    });
    console.log(JSON.stringify(data));
}
main();

Weitere Optionen und detaillierte Beschreibungen der Parameter finden Sie in der folgenden CLI-Dokumentation:

Entwicklung

vis-1

• start dev-server mitdev-server watch --noStart
• Adapter mit Startkonfiguration "default Launch ioBroker Adapter" starten
• Starte das Überwachungsskript im Widget-Verzeichnis mitnpm run watch
• Vis-1-Editor oder Laufzeitumgebung öffnen
• Wenn Sie im vis-1-Widget etwas ändern, warten Sie einige Sekunden, bis die Änderungen auf den Entwicklungsserver hochgeladen sind.
• in vis-1 die Seite vis-1 neu laden
• Wenn sich etwas in der Datei squeeboxrpc.html geändert hat, müssen Sie den Vis-1-Adapter neu starten.

vis-2

• Zum Debuggen des vis-2-Widgets müssen Sie vis-2 in einem zweiten vis-2-Fenster ausführen.
• Zur Installation und Ausführung folgen Sie den Anweisungen unter https://github.com/ioBroker/ioBroker.vis-2#development-and-debugging
• Adapter mit Startkonfiguration "default Launch ioBroker Adapter" starten
• Starten Sie den Vite-Entwicklungsserver im Verzeichnis src-widgets mitnpm run start
• Im iobroker-Adminbereich/Registerkarte „Objekte“ bearbeiten Sie im Expertenmodus das Objekt vonsystem.adapter.squeezeboxrpc.0
• Ändern Sie common.visWidgets.vis2vis-squeezeboxrpc.url von vis2squeezeboxrpc/customWidgets.js in http://localhost:4173/customWidgets.js. Dies ist die Adresse des Vite-Definitionsservers.
• Öffnen Sie vis im Bearbeitungs- oder Laufzeitmodus mit der Startkonfiguration "vis2 edit 3000" oder "vis2 runtime 3000".
• Wenn Sie etwas im Code des Vis-2-Widgets ändern, wird ein automatisches Neuladen ausgelöst, oder Sie drücken F5 im Browser.

abschließender Laufzeittest

• stoppendev-server und Ihr Adapter in VS Code
• Erstelle einen Produktions-Build und lade ihn mit dem Build auf den Entwicklungsserver hoch.dev-server upload
• iobroker starten mitnpm run start
• Die Änderung in system.adapter.squeezeboxrpc.0 wird auf den ursprünglichen Wert zurückgesetzt.
• Öffnen Sie vis-1 oder vis-2 im Bearbeitungs- oder Laufzeitmodus.

zusätzlicher Test auf einem echten iobroker-Server

• Erstellen Sie im Stammverzeichnis eine npm-Paketdatei mitnpm pack
• Drücken Sie in iobroker auf der Registerkarte „Admin/Adapter“ im Expertenmodus die Schaltfläche „Katze“.
• Wählen Sie im Dialogfeld die Registerkarte aus.from file
• Wählen Sie die erstellte Paketdatei aus.
• Installationsanleitung drücken
• Wenn etwas nicht funktioniert, beim Start der Shelliobroker upload all

Todo

• Widget „Spielergesteuerter Drehknopf“ hinzufügen
• Die Wiedergabe wird gestoppt, wenn die Favoritentaste erneut gedrückt wird. (Nicht implementiert)
• mehr Tests/Fehlerbehebungen
• Mehr Konfigurationsmöglichkeiten zum optionalen Ein-/Ausschalten von Funktionen zur Verbesserung von Speicher und Leistung
• Playlist-Widget hinzufügen
• Widget zum Durchsuchen hinzufügenLMS -Speisekarte
• Abhängigkeiten zu anderen Paketen reduzieren (squeezenode)
• cmdGeneral für Server.
• Fügen Sie eine Telnet-Kommunikation hinzu, um Push-Ereignisse vom Server zu erhalten und so das Polling zu optimieren.
• Implementiere einen Befehlsstatus, um benutzerdefinierte Befehle (via JSON) für Server und Spieler zu platzieren.
• mehr Steuerungsfunktionen implementieren (Wiedergabeposition auswählen, vorspulen, zurückspulen, zu einer bestimmten Position im Lied springen, Lied wiederholen, zufälliges Lied)
• Füge die Playlist als JSON-Array zu den Playerdaten hinzu.
• Füge Grafiken (Senderlogo/Playlist-Cover) für Favoriten hinzu
• Implementieren Sie weitere Ebenen (Unterverzeichnisse) von Favoriten
• Logitech Media Server automatisch erkennen

Changelog

3.0.1 (2026-09-08)

• fix little regressions

3.0.0 (2026-09-07)

• complete rework of the LMS API
• add experimental websocket support, only usable with LMS 9.2 build after 5.9.2026

2.0.2 (2026-09-07)

• fix io-package.json

2.0.1 (2026-09-05)

• fix package-lock
• fix tests

2.0.0 (2026-09-05)

• power/connected state fixed
• players button font size fixed
• bring back fade in/out for Announcement with additional LMS plugin

Older entries are in CHANGELOG_OLD.md.

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Copyright (c) 2019-2026 oweitman