Onkyo Smart-Home-Integration, kostenlos und Open Source

Onkyo-, Integra- und Pioneer-AV-Receiver im Netzwerk steuern: Ein/Aus, Lautstärke, Eingänge, Zonen.
Diese Integration steuert Onkyo-AV-Receiver im Netzwerk aus Gladys heraus, ebenso die Modelle von Integra und die neueren von Pioneer, die dasselbe Protokoll (eISCP) sprechen.
Alles bleibt lokal: Gladys spricht direkt in deinem Netzwerk mit dem Receiver (Port 60128). Kein Konto, keine Cloud, kein Internet.
Bevor du beginnst
- Der Receiver muss im Netzwerk sein (Kabel oder WLAN).
- Aktiviere am Receiver Netzwerk-Standby:
Setup→Hardware→Power Management→Network Standby→On(die Bezeichnungen variieren je nach Modell etwas). Ohne diese Option trennt sich der Receiver im Standby vom Netzwerk: Gladys verliert ihn und kann ihn nicht einschalten. - Gib ihm eine feste IP in deinem Router (empfohlen, aber nicht nötig: Ändert sich die IP, findet die Integration den Receiver über seine MAC-Adresse wieder).
Manche ältere Modelle akzeptieren nur eine Verbindung gleichzeitig: Ist die App Onkyo Remote geöffnet, kann der Receiver Gladys ablehnen. Schließe die App und warte eine Minute.
Einen Receiver hinzufügen
- Installiere die Integration aus dem Gladys-Store.
- Öffne den Tab Entdecken: Gladys sucht im Netzwerk nach Receivern.
- Füge die angezeigten Receiver hinzu. Pro Zone wird ein Gerät angelegt.
Der Receiver erscheint nicht? Er befindet sich vielleicht in einem anderen Subnetz oder einem VLAN: Gib seine IP unter Adressen der Receiver ein (mehrere durch Kommas getrennt), speichere und starte die Suche erneut.
Einstellungen
| Einstellung | Wirkung |
|---|---|
| Adressen der Receiver | Nur für einen Receiver, den die Suche nicht findet. Z. B. 192.168.1.40, 192.168.1.41 |
| Zonen | Automatisch: die Zonen, die der Receiver meldet (bei älteren Modellen nur die Hauptzone). Oder erzwinge 1, 2 oder 3 Zonen. |
| Lautstärkeskala des Receivers | Der höchste Lautstärkewert, den der Receiver anzeigt: 80 bei den meisten Modellen, 200 bei neueren, die in 0,5er-Schritten zählen. „Verbindung testen“ zeigt den Wert an. |
| Maximale Lautstärke (%) | Gladys sendet nie eine höhere Lautstärke, egal was ein Schieberegler, eine Taste oder eine Szene verlangt. Standardmäßig 80 %. |
| Detaillierte Protokolle | Protokolliert jede mit dem Receiver ausgetauschte Nachricht. Aktiviere es, um ein Problem zu verstehen, und schalte es danach wieder aus. |
Die Lautstärke ist ein Prozentsatz der Skala: 50 % bei einer Skala von 80 zeigt am Receiver 40 an.
Was du erhältst
Hauptzone
- Ein/Aus (ein / Standby)
- Lautstärke (Schieberegler, in %), Lauter, Leiser, Stumm (Umschalten)
- Eingang: die Liste der Eingänge, mit den Namen, die du ihnen am Receiver gegeben hast (neuere Modelle), oder den Standardnamen (BD/DVD, CD, NET…)
- Wiedergabemodus: Stereo, Direct, Dolby, DTS…
- Tuner-Senderspeicher (1 bis 40)
- Play, Pause, Stop, Zurück, Weiter: für den Netzwerk-, USB- oder Bluetooth-Player des Receivers
- Aktuelle Wiedergabe: Interpret und Titel
Zone 2 und Zone 3
Ein/Aus, Lautstärke, Stumm, lauter/leiser, Eingang. Der Eingang „Quelle der Hauptzone“ lässt die Zone der Hauptzone folgen.
Jede Änderung über die Fernbedienung, die Gerätefront oder eine andere App erscheint sofort in Gladys: Der Receiver meldet sie, Gladys muss nicht abfragen.
Szenen (Gladys 5.1+)
Auslöser
- Der Eingang eines Receivers hat sich geändert: Jemand hat einen anderen
Eingang gewählt (Fernbedienung, Gerätefront, App). Filter nach Zone und
Eingang. Variablen:
source(Code) undsource_name(Name). Befehle von Gladys selbst lösen ihn nie aus (keine Schleife). - Ein neuer Titel wird abgespielt: Der Netzwerk- oder USB-Player ist zu einem
anderen Titel gewechselt. Variablen:
title,artist,album. - Ein Receiver ist online oder offline gegangen: Die Verbindung ist abgebrochen (ausgesteckt, Netzwerk-Standby aus) oder wiederhergestellt. Ein Neustart von Gladys löst ihn nie aus.
Aktionen
- Eingang auf einem Receiver abspielen: Schaltet die Zone bei Bedarf ein, wartet auf sie, wählt den Eingang und stellt dann die Lautstärke ein (optional). Gedacht für „das Radio in der Küche um 7:00 Uhr“.
- Receiver stummschalten: stumm, Ton ein oder umschalten.
- Wiedergabemodus einstellen für die Hauptzone.
- ISCP-Befehl senden: beliebiger Befehl des Onkyo-Protokolls, für alles, was die anderen Aktionen nicht abdecken. Die Antwort des Receivers steht den folgenden Aktionen zur Verfügung.
Beispiel: „Wenn sich der Fernseher einschaltet → Eingang TV mit 35 % abspielen“.
Dashboard-Widget (Gladys 5.1+)
Das Widget Onkyo-Receiver zeigt eine Zone (in seinen Einstellungen gewählt, sonst die Hauptzone des ersten Receivers):
- Lautstärke und Eingang;
- Status: Betrieb, laufender Titel, Ton, Wiedergabemodus, Verbindung;
- Tasten: Ein/Standby, leiser, lauter, stumm, wenn die Zone eingeschaltet ist; Einschalten und Quelle abspielen, wenn sie im Standby ist.
Quelle abspielen öffnet ein kleines Formular: Wähle einen Eingang der Zone (der aktuelle ist vorausgefüllt) und, wenn du möchtest, eine Lautstärke in %, begrenzt durch die Einstellung Maximale Lautstärke. Gladys schaltet die Zone ein, wartet auf sie, wählt dann den Eingang und stellt die Lautstärke ein, genau wie die Szenen-Aktion. Dieses Formular erfordert Gladys 5.2 oder neuer, was die Integration inzwischen voraussetzt.
Schaltflächen der Konfiguration
- Verbindung testen: eine Zeile pro Zone (verbunden oder nicht, Betrieb, Eingang, Lautstärke) und die eingegebenen Adressen, die nicht geantwortet haben.
- ISCP-Befehl senden: Probiere einen Befehl aus, bevor du ihn in eine
Szene einbaust. Beispiele:
PWR01(einschalten),MVL20(Lautstärke),SLI23(Eingang CD),LMDQSTN(welcher Wiedergabemodus?).
Fehlerbehebung
| Problem | Hinweis |
|---|---|
| Der Receiver erscheint nicht unter „Entdecken“ | Netzwerk-Standby aktiviert? Im selben Netzwerk wie Gladys? Sonst gib seine IP unter „Adressen der Receiver“ ein. |
| „Nicht erreichbar“, sobald er im Standby ist | Aktiviere Netzwerk-Standby (siehe oben). |
| Die Lautstärke passt nicht zur Anzeige | Stelle die „Lautstärkeskala des Receivers“ ein (meist 80 oder 200). |
| Ein Eingang fehlt in der Liste | Ältere Modelle melden ihre Eingänge nicht: Dann wird die Standardliste verwendet. Nutze „ISCP-Befehl senden“ mit SLIxx. |
| Play/Pause bewirken nichts | Diese Tasten steuern den eigenen Netzwerk-/USB-/Bluetooth-Player des Receivers, keine HDMI-Quelle. |
Für einen Fehlerbericht aktiviere Detaillierte Protokolle, reproduziere das Problem und hänge die Protokolle ohne IP- oder MAC-Adressen an: https://github.com/prohand/gladys-onkyo/issues
Konfigurationseinstellungen
Diese Einstellungen fragt Onkyo in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Receiver werden in deinem Netzwerk gefunden: Öffne den Tab „Entdecken“ und füge sie hinzu. Alles bleibt lokal (eISCP-Protokoll, Port 60128), ohne Konto und ohne Cloud. Aktiviere am Receiver Netzwerk-Standby (Setup > Hardware > Power Management), sonst verliert Gladys ihn, sobald er in den Standby wechselt. |
| Adressen der Receiver | string | Nein | Nur für einen Receiver, den der Tab „Entdecken“ nicht findet (anderes Subnetz, VLAN): seine IP-Adresse, mehrere durch Kommas getrennt. Eine feste IP in deinem Router wird empfohlen. |
| Zonen | select | Nein | Ein Gladys-Gerät pro Zone. Automatisch: die Zonen, die der Receiver meldet (bei älteren Modellen nur die Hauptzone). |
| Lautstärkeskala des Receivers | select | Nein | Der höchste Lautstärkewert, den der Receiver anzeigt. 80 bei den meisten Modellen, 200 bei neueren, die in 0,5er-Schritten zählen. „Verbindung testen“ zeigt, was der Receiver meldet. |
| Maximale Lautstärke (%) | number | Nein | Gladys sendet nie eine höhere Lautstärke, egal was eine Szene oder ein Schieberegler verlangt: Das schützt deine Lautsprecher und deine Ohren. |
| Detaillierte Protokolle (Debug) | boolean | Nein | Protokolliert jede mit den Receivern ausgetauschte Nachricht. Aktiviere es, um ein Problem zu verstehen, und schalte es danach wieder aus: Es ist sehr ausführlich. |
So installierst du Onkyo in Gladys
- Öffne in Gladys Integrationen: Onkyo erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-onkyo:1.2.1) 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/prohand/gladys-onkyo.
Onkyo benötigt Gladys >=5.2.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
Onkyo 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 prohand 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