OwnTone Smart-Home-Integration, kostenlos und Open Source

OwnTone-Musikserver: Player, AirPlay- und Chromecast-Ausgaben, Playlists, Lautstärke pro Raum.
Diese Integration steuert einen OwnTone-Server (früher forked-daapd) aus Gladys: den Player (Wiedergabe, Pause, weiter, Lautstärke, was läuft) und jede Ausgabe, AirPlay- und Chromecast-Lautsprecher oder das lokale Audio, die du ein- und ausschaltest und deren Lautstärke du Raum für Raum einstellst. Die Integration spricht mit OwnTone im lokalen Netz über seine JSON-API und folgt jeder Änderung live über seinen WebSocket. Keine Cloud, kein Konto.
Getestet mit einem echten OwnTone 29.3 in Docker, ohne AirPlay- oder Chromecast-Lautsprecher: Rückmeldungen willkommen. Wiedergabe, Lautstärken, Auswahl der Ausgaben, Benachrichtigungen und der Neustart von OwnTone wurden echt geprüft, an seiner lokalen und seiner fifo-Ausgabe.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer.
- Ein OwnTone-Server (Version 28 oder neuer), von Gladys aus erreichbar auf dem Port seiner
Weboberfläche, standardmäßig 3689, und auf seinem WebSocket-Port (
websocket_portinowntone.conf, standardmäßig 3688). - Gladys in den
trusted_networksvonowntone.conf, oder dasadmin_passwordvon OwnTone in der Konfiguration eingetragen.
Konfiguration
- Serveradresse: die IP-Adresse oder der Hostname des Rechners, auf dem OwnTone läuft, wie für
seine Weboberfläche. Ergänze
:Port, wenn er nicht 3689 ist (http://192.168.1.20:3689geht auch). - Port: 3689, außer du hast
portim Abschnittlibraryvonowntone.confgeändert. - Admin-Passwort (optional): nur wenn Gladys außerhalb der
trusted_networksvon OwnTone liegt. Standardmäßig vertraut OwnTone dem lokalen Netz und will kein Passwort. - Sprache: die Sprache der Funktionsnamen und der Texte, die die Integration schreibt. Funktionsnamen werden beim Hinzufügen des Geräts festgelegt.
Öffne dann den Tab Entdecken und füge den Player und die gewünschten Ausgaben hinzu.
Geräte
Player
Der Player von OwnTone, einer pro Server:
- Lautstärke (0 bis 100): die Gesamtlautstärke. OwnTone passt jede gewählte Ausgabe daran an.
- Wiedergabestatus: spielt oder nicht.
- Wiedergabe, Pause, Vorheriger Titel, Nächster Titel: Tasten.
- Aktuelle Wiedergabe: Titel und Interpret, mit dem Status, wenn pausiert oder gestoppt.
Diese Funktionen gehören zur Kategorie Musik von Gladys: Die Musik-Box des Dashboards steuert den Player.
Ausgaben
Ein Gerät pro Ausgabe von OwnTone: AirPlay- oder Chromecast-Lautsprecher, lokales Audio (ALSA, PulseAudio), fifo.
- Ausgewählt: an, OwnTone spielt auf dieser Ausgabe; aus, nicht. Ein Lautsprecher, den du während der Wiedergabe einschaltest, kommt sofort zur Gruppe dazu.
- Lautstärke (0 bis 100): die Lautstärke dieser Ausgabe.
Eine Ausgabe, die OwnTone verlässt (Lautsprecher aus, nicht im Netz), erscheint als nicht ausgewählt und behält ihr Gerät in Gladys; sie kommt von selbst wieder.
Dashboard-Widget
OwnTone: was läuft (Titel, Interpret, Album), Status und Lautstärke des Players, die Ausgaben mit ihrer Lautstärke (oder „Aus“) und vier Tasten: Wiedergabe oder Pause, weiter, leiser, lauter (in Fünferschritten).
Szenen-Auslöser
- Wiedergabe gestartet: OwnTone beginnt zu spielen. Variablen: Titel, Interpret, Album.
- Wiedergabe gestoppt: OwnTone hört auf zu spielen, pausiert oder gestoppt, seit mindestens 5 Sekunden (OwnTone meldet bei jedem Titelwechsel kurz „Pause“). Filter: pausiert, gestoppt oder beides. Variablen: Titel, Interpret, Album.
- Ausgabe verschwunden: eine Ausgabe verlässt OwnTone. Filter: eine Ausgabe oder alle. Variable: der Name der Ausgabe.
- Ausgabe erschienen: eine Ausgabe kommt (wieder) zu OwnTone. Filter: eine Ausgabe oder alle. Variable: der Name der Ausgabe.
Szenen-Aktionen
- Playlist abspielen: ersetzt die Warteschlange durch eine OwnTone-Playlist und spielt sie. Gib
ihren Namen ein (Groß- und Kleinschreibung und Akzente egal; ein Teil des Namens reicht, wenn nur
eine Playlist passt) oder eine URI (
library:playlist:8,spotify:playlist:…, die Adresse eines Internetradios). Mit bis zu drei gewählten Ausgaben spielen nur diese; ohne Ausgabe bleiben die Ausgaben, wie sie sind. Ausgabe: der Name der gespielten Playlist. - Lautstärke einstellen: einer Ausgabe (eines Raums) oder des Players (alle gewählten Ausgaben folgen).
- Alles stoppen: stoppt die Wiedergabe; oder stoppt sie und schaltet alle Ausgaben ab, was die AirPlay-Lautsprecher für andere Apps freigibt.
Szenen-Beispiele
- Mit Musik aufwachen: werktags um 7:00 „Playlist abspielen“
Morgenauf dem Lautsprecher im Schlafzimmer, dann „Lautstärke einstellen“ dieser Ausgabe auf 25. - Das Haus verlassen: wenn das Haus leer wird, „Alles stoppen“ und alle Ausgaben abschalten.
- Das Licht folgt der Musik: bei „Wiedergabe gestartet“ nach Sonnenuntergang das Wohnzimmer dimmen; bei „Wiedergabe gestoppt“ wieder aufhellen.
Fehlerbehebung
- „Der OwnTone-Server antwortet nicht“: Prüfe Adresse und Port, dann ob sich die Weboberfläche von einem anderen Gerät im Netz öffnet.
- „OwnTone lehnt das Passwort ab“: Gib das
admin_passwordausowntone.confein. OwnTone verlangt es für jede Adresse außerhalb seinertrusted_networks. - „OwnTone lehnt Gladys ab“: OwnTone hat kein
admin_passwordund vertraut dem Netz von Gladys nicht: Setze eines oder füge dieses Netz zutrusted_networkshinzu. - Zustände kommen nur alle 5 Sekunden: Der WebSocket-Port von OwnTone (3688) ist nicht
erreichbar, oder
websocket_portist 0. Die Integration liest OwnTone dann alle 5 Sekunden. Die Protokolle melden es beim Verbinden. - „OwnTone konnte diese Ausgabe nicht nutzen“: Der Lautsprecher ist aus, von einer anderen Quelle belegt oder verlangt ein Passwort oder einen Kopplungscode: Kopple ihn einmal über die Weboberfläche von OwnTone.
- „Die Warteschlange von OwnTone ist leer“: Wiedergabe braucht etwas in der Warteschlange: Starte zuerst eine Playlist.
Grenzen
- Ein OwnTone-Server pro Integration, von Hand eingetragen (die Sandbox von Gladys hat kein eigenes mDNS).
- Keine Kopplung von AirPlay-Lautsprechern, die einen Code verlangen, und kein Ausgabepasswort: Mach das einmal in der Weboberfläche von OwnTone.
- Eine Playlist wird über Namen oder URI gewählt: kein Blättern in Bibliothek, Alben oder Interpreten.
- Ohne AirPlay- oder Chromecast-Lautsprecher entwickelt: Deren Verhalten stammt aus der API von OwnTone, nicht aus einem Test mit der Hardware. Rückmeldungen willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt OwnTone in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Verbinde deinen OwnTone-Server | section | Nein | Gib die Adresse des Rechners ein, auf dem OwnTone (früher forked-daapd) läuft, wie für seine Weboberfläche. Die Integration nutzt seine JSON-API (Port 3689) und folgt jeder Änderung live über seinen WebSocket (standardmäßig Port 3688). Der Player wird ein Gerät, jede Ausgabe (AirPlay- oder Chromecast-Lautsprecher, lokales Audio) auch. |
| Serveradresse | string | Ja | IP-Adresse oder Hostname von OwnTone. Ergänze :Port, wenn seine Weboberfläche nicht auf Port 3689 läuft. |
| Port | number | Nein | Port der Weboberfläche und der JSON-API (port im Abschnitt library von owntone.conf). |
| Admin-Passwort (optional) | secret | Nein | Nur wenn Gladys außerhalb der trusted_networks von owntone.conf liegt: sein admin_password. |
| Optionen | section | Nein | Sprache der Namen und Texte, die die Integration erzeugt (Funktionsnamen werden beim Hinzufügen des Geräts festgelegt). |
| Sprache | select | Nein |
So installierst du OwnTone in Gladys
- Öffne in Gladys Integrationen: OwnTone erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-owntone:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-owntone.
OwnTone benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
OwnTone ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation