AirPlay-Geräteauswahl und getrennte Raumlautstärken unter Linux
  • Python 94.4%
  • JavaScript 5.6%
Datei suchen
2026-10-27 17:26:05 +01:00
branding AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
defaults AirPlay-Unterstützung für Linux 0.5.0: Benutzer- und Installationsvoreinstellungen 2026-10-27 17:26:05 +01:00
panel AirPlay-Unterstützung für Linux 0.4.0: Geräteauswahl und Lautstärken im oberen Panel 2026-10-27 17:04:02 +01:00
activate.py AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
airplay_settings.py AirPlay-Unterstützung für Linux 0.3.0: Geräteauswahl in ENZCOM Einstellungen und signierte Paketversorgung 2026-10-27 16:39:11 +01:00
branding-check.py AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
branding-lock.json AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
configure-network.py AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
controls.py AirPlay-Unterstützung für Linux 0.2.1: Gerätemodelle in der Auswahl 2026-10-19 17:32:55 +02:00
de.enzcom.AirPlay.desktop AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
enzcom-airplay.service AirPlay-Unterstützung für Linux: Installation und Quellen 2026-10-19 14:52:45 +02:00
group-output.py AirPlay-Unterstützung für Linux 0.2.2: Gemeinsame Startplanung mit ausreichender Bestätigungszeit 2026-10-19 18:02:09 +02:00
install-group.py AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00
install-ui.py AirPlay-Unterstützung für Linux 0.2.1: Gerätemodelle in der Auswahl 2026-10-19 17:32:55 +02:00
LICENSE AirPlay-Unterstützung für Linux: Installation und Quellen 2026-10-19 14:52:45 +02:00
OS-INTEGRATION.md AirPlay-Unterstützung für Linux 0.5.0: Benutzer- und Installationsvoreinstellungen 2026-10-27 17:26:05 +01:00
README.md AirPlay-Unterstützung für Linux 0.3.0: Geräteauswahl in ENZCOM Einstellungen und signierte Paketversorgung 2026-10-27 16:39:11 +01:00
verify-multiroom.py AirPlay-Unterstützung für Linux 0.3.0: Geräteauswahl in ENZCOM Einstellungen und signierte Paketversorgung 2026-10-27 16:39:11 +01:00
verify-start.py AirPlay-Unterstützung für Linux 0.2.2: Gemeinsame Startplanung mit ausreichender Bestätigungszeit 2026-10-19 18:02:09 +02:00
verify.py AirPlay-Unterstützung für Linux 0.2.0: Geräteauswahl und getrennte Raumlautstärken 2026-10-19 17:10:45 +02:00

Version 0.3.0 – ENZCOM-Einstellungen und Paketversorgung

Neue ENZCOM-Installationen beginnen ohne ausgewählte Empfänger. Die Geräteauswahl liegt unter ENZCOM Einstellungen → Geräte verbinden → AirPlay-Geräte. Kein zweiter Einstellungsstarter. Der gemeinsame Hauptregler beginnt bei neuen Installationen mit 25 %, Raumregler bei 100 %; beide sind frei anpassbar. Bestehende Profile und Gruppeneintragungen bleiben erhalten. Die erste Auswahl ändert noch nicht den Audioausgang; dafür ausdrücklich „Für Wiedergabe verwenden“ wählen.

Audiotransport unverändert aus 0.2.2: gemeinsame Startplanung, 2100 ms Vorlauf, PCM-Regelung und feste Empfängerreferenz. Die leere Anfangsauswahl und neue Initialisierung verändern keine vorhandenen Home-Gruppen. Paket enzcom-airplay über updates.enzcom.cloud; Quellen und vorangehende Releases bleiben erhalten. LAN-spezifische Firewallfreigabe separat mit configure-network.py konfigurieren. Die ältere Standalone-Installation unten gilt weiterhin für vorhandene Stereo-Gruppeneintragungen; neue OS-Installationen verwenden das DEB.

Version 0.2.2 – Gemeinsamer Start mit ausreichender Bestätigungszeit

Der Verbindungsaufbau reserviert sechs Sekunden für die gemeinsamen Startbestätigungen, bevor die PCM-Zufuhr beginnt. Der PCM-Vorlauf bleibt exakt 2100 ms. Zuvor blieben nur 500 ms für die Bestätigungen; bei langsamer Antwort eines gepufferten Empfängers konnte schon die erste Audiozufuhr ihre Frist verfehlen und alle Verbindungen abbrechen. Alle Geräte müssen denselben Startzeitpunkt vor einer gemeinsamen Deadline bestätigen. Ausbleibende oder abweichende Bestätigungen geben keine regulären Audioblöcke frei.

Zusätzlich ist die Übergabe an Empfängerprozesse durch die bestehende gemeinsame 500-ms-Frist begrenzt. Ein nicht lesender Empfänger kann die Audiozufuhr nicht unbegrenzt blockieren; es werden keine zusätzlichen Audiopuffer angelegt.

Das verlängert ausschließlich den Verbindungsaufbau, nicht den Puffer der laufenden Wiedergabe. Bestehende Gruppen, gespeicherte Pegel/Mute, PCM-Regelung und PTP-Routen bleiben erhalten. Begrenzte Diagnose nennt nur Fehlercodes, Empfängerindex und Zeiten. Die Korrektur behandelt diesen nachgewiesenen Startfehler; sie ist keine Garantie gegen beliebige WLAN-, Geräte- oder Netzwerkstörungen.

Update von 0.2.0/0.2.1: sudo python3 install-group.py, anschließend als angemeldeter Desktopbenutzer python3 activate.py. Beide Schritte sichern den vorherigen Stand; der Aktivierungsablauf erhält Pegel und Routing. install-ui.py reicht für dieses Transportupdate nicht aus.

Version 0.2.1 – Gerätemodelle

Die Auswahl zeigt unter jedem Raumnamen das angekündigte Produktmodell. HomePod-mini-Kennungen werden lesbar als „HomePod mini“ angezeigt, Stereopaare beispielsweise als „2 × HomePod mini“. Unbekannte Kennungen bleiben sichtbar; fehlt die Angabe, wird kein Produkt geraten. Modellzeile und Verbindungsstatus bleiben getrennt sichtbar. Dies ist eine reine Anzeigeänderung; Audioübertragung, Vorlauf und Gerätekompatibilität ändern sich nicht.

AirPlay-Unterstützung für Linux 0.2.2

Native Geräteauswahl unter Zorin OS 18 / Ubuntu 24.04 (x86_64). Im Anwendungsmenü „AirPlay-Geräte“ öffnen, gewünschte Räume anhaken und deren Lautstärke getrennt regeln oder stummschalten. Vorhandene Stereopaare erscheinen als ein Raumziel; Apple-Home-Gruppen werden weder angelegt noch verändert.

Bedienung

  • Auswahl, Raumlautstärke und Stummschaltung werden je Benutzer gespeichert und beim nächsten Anmelden wieder verwendet. Zunächst bleibt nur das bisher eingerichtete Stereopaar ausgewählt; weitere Geräte werden nicht automatisch aktiv.
  • Der Ausgang in Zorin heißt „AirPlay“. Seine technische Kennung bleibt erhalten. Der Zorin-Systemregler steuert weiterhin die Hauptlautstärke und Balance.
  • „Für Wiedergabe verwenden“ setzt AirPlay ausdrücklich als Standardausgang und verschiebt aktuell laufende Audiostreams dorthin. Die Installation selbst erhält die vorherige Zuordnung und den bisherigen Standardausgang.
  • Raumregler und Hauptregler wirken gemeinsam. Bei jeder Verbindung wird ein definierter Empfangspegel gesetzt; gespeicherte Raumpegel und Stummschaltung gelten schon für den ersten gesendeten Ton. Manuelles Anheben in Home ist nicht erforderlich. Während der Wiedergabe regeln die Schieberegler den gesendeten Ton; direkte Änderungen in Home werden nicht in diese Regler zurückgespiegelt.
  • „Geräte aktualisieren“ sucht erneut im Netzwerk. Nicht erreichbare gespeicherte Ziele bleiben sichtbar. Fehlende Partner eines Stereopaars, geänderte Gruppen, geschützte Verbindungen ohne eingerichtete Anmeldung und fehlende AirPlay-2-/PTP- Unterstützung werden nicht stillschweigend durch andere Geräte ersetzt.
  • Auswahländerungen verbinden die ausgewählten Geräte gemeinsam neu und verursachen eine kurze Unterbrechung. Lautstärke/Mute allein erfordern keine neue Verbindung.
  • Nicht verbindbare Ziele blockieren die übrigen bereiten Räume beim Start nicht. Die Oberfläche nennt tatsächlich spielende Räume und zeigt getrennt die nicht verbundenen Ziele mit ihrem Fehlergrund. Gespeicherte Auswahl bleibt erhalten; ein Stereopaar wird niemals nur mit einem Partner gestartet. Bei Auswahländerung oder neuer Wiedergabesitzung wird die Verbindung erneut versucht.
  • Bis zu acht physische Lautsprecher gleichzeitig. Ein Stereopaar zählt als zwei.

Audio und Grenzen

Eine gemeinsame PTP-Zeitbasis und identische bestätigte Startzeitpunkte für alle Empfänger. Der PCM-Vorlauf ist fest 2100 ms; Geräte mit mehr als 2000 ms gemeldetem Vorlauf werden abgewiesen, damit diese Grenze nicht unbemerkt erhöht wird. Nur bei aktiver lokaler Sitzung und zugeordneten laufenden Audiostreams wird übertragen. Nach Pause/Ende folgt ein achtsekündiger Nachlauf. Keine Eignungszusage für Gespräche oder lippensynchrones Video und kein Versprechen nahtlosen Beitritts während Musik.

Pegel und echtes Mute werden kanalweise unmittelbar vor zeitlich begrenzter Übergabe im PCM angewendet. PulseAudio-Kennlinie, maximal 100 %, ohne feste Vordämpfung. Einzelne Raumregler verwenden dieselbe Kennlinie zusätzlich zur Hauptlautstärke. Jeder Empfänger erhält beim Verbindungsaufbau einmal den Referenzpegel 100 (0 dB); die erfolgreiche SET_PARAMETER-Antwort wird vor START verlangt. Gespeicherte Raumpegel, Mute und Hauptpegel wirken bereits vor dem Audiopuffer. Bei 100 % an beiden Reglern sind PCM-Samples bitgleich zum Eingang; 0 %/Mute ergibt echte Stille. Laufende Regleränderungen verwenden weiterhin ausschließlich PCM, keine dynamischen VOLUME-Befehle. Der angezeigte Home-Gerätepegel kann deshalb vom wirksamen Notebook-Regler abweichen. Eine Antwort bestätigt den Befehl, ersetzt aber keine Hörprüfung. Überspringen der Initialisierung mit --volume 0 erhielt Gerätepegel im Betrieb nicht zuverlässig; diese frühere Annahme ist verworfen. Die 800-ms-Variante wurde verworfen; sie ist nicht Bestandteil dieses Releases. Bei verlorener Zeitsteuerung oder mehr als 500 ms Verspätung wird die Verbindung geschlossen statt ein Rückstau aufgebaut.

Hörprüfung am 19.10.2026: zwei bestehende HomePod-Stereopaare gleichzeitig; Anwender bestätigt Gleichlauf, getrennte wiederholte Pegeländerungen und vollständige Stille je Raum. Kein akustisch gemessener Millisekundenvergleich und kein Langzeittest. Andere AirPlay-2-Geräte können angezeigt werden, sind dadurch aber noch nicht als kompatibel im Zusammenspiel abgenommen. Kein Import von Apple-Zugangsdaten; PIN-/kennwortgeschützte Empfänger sind in dieser Fassung nicht eingerichtet.

Reines Anzeigeupdate bei identischem Audiotransport

sudo python3 install-ui.py sichert und ersetzt nur Oberfläche und Erkennungsanzeige. Der Audiotransport muss bytegleich sein; andernfalls bricht dieser Ablauf ab. Danach „AirPlay-Geräte“ schließen und erneut öffnen. Der Audiodienst wird nicht neu gestartet, Einstellungen werden nicht geschrieben.

Modellzuordnungen: https://github.com/music-assistant/server/blob/dev/music_assistant/providers/airplay/helpers.py

Installation und Sicherung

Benötigt PipeWire/PulseAudio-Schnittstelle, Avahi, Python 3 mit dbus-python und GTK 3 (PyGObject), pactl, parec, pw-dump, pw-cli, stdbuf, systemd und setcap. Bestehende geprüfte Eintragung unter /etc/enzcom-airplay/group.json erforderlich:

{"name":"Raumname","devices":["aa:bb:cc:dd:ee:01","aa:bb:cc:dd:ee:02"],"stereo_pair":"00000000-0000-0000-0000-000000000000"}

Die Beispielkennungen durch tatsächlich überprüfte Werte ersetzen. Vorhandene Eintragungen nicht überschreiben. Nach Entpacken sudo python3 install-group.py: Installer prüft Branding und feste Upstream-Hashes und sichert betroffene System- dateien und Autostartstand datiert unter /var/backups/enzcom/airplay-install-*. Keine automatische Änderung von Benutzerprofilen oder Home-Gruppen. Die neue Bedienoberfläche verwendet die freigegebene ENZCOM-Wortmarke und das standardmäßige Audio-Funktionssymbol des Desktops.

Als angemeldeter Desktopbenutzer python3 activate.py ausführen: Pegel, Mute und Zuordnung der laufenden Streams werden vor dem kurzen Dienstneustart unter ~/.local/state/enzcom-airplay/activation-* gesichert und anschließend erhalten. Der bisherige ergänzte Dienst bleibt beim nächsten grafischen Login automatisch aktiv. ~/.config/enzcom-airplay/devices.json enthält die private Auswahl und Raumpegel, keine Zugangsdaten; atomare Schreibvorgänge mit Dateisperre verhindern unvollständige Einstellungen. Änderungen am Hauptausgang bleiben normale PipeWire-Einstellungen. Vor manueller Profilbearbeitung diese Datei datiert sichern.

Bei aktiver UFW-Firewall benötigt die gemeinsame Zeitsteuerung eingehende UDP- Pakete auf 319/320 aus dem vertrauenswürdigen lokalen Netz. configure-network.py richtet dafür nach Sicherung von /etc/ufw eine begrenzte Regel ein. Interface und Netz müssen ausdrücklich angegeben werden; nur ein direkt angeschlossenes privates Netz mit höchstens 1024 Adressen wird akzeptiert. Beispiel (eigene Werte verwenden): sudo python3 configure-network.py --interface wlan0 --network 192.168.1.0/24. Keine Firewallabschaltung und keine weltweite Portfreigabe. Andere Regeln bleiben unverändert. Ein Interface-/Netzwechsel braucht eine passend geprüfte Freigabe.

Die Oberfläche nennt bei Verbindungsfehlern den Empfänger und unterscheidet fehlende Gerätefreigabe, ausbleibende Zeitsteuerung und fehlenden Audiopuffer. Geräte können eine Kopplung verlangen, obwohl ihre Netzankündigung keine PIN-Pflicht nennt. Dafür gibt es derzeit noch keinen Kopplungsdialog; Zugriffsregeln am Gerät bleiben unverändert. Ein angezeigtes Gerät ist daher keine Zusage erfolgreicher Wiedergabe.

Die frühere feste Dämpfung von −21 dB ist entfernt. Beim ersten Wechsel auf die neue Skala wird der Hauptregler einmalig kanalweise umgerechnet, damit die hörbare Lautstärke nicht springt: alter Regler × 10^(−21/60), abgerundet auf PulseAudio- Ganzzahlen. Beispiel: bisher 100 % entspricht jetzt rund 44,7 %, bisher 56 % etwa 25 %. Raumregler/Mute bleiben erhalten. Vorheriger Pegel und Migration werden unter ~/.local/state/enzcom-airplay/volume-scale-before-* gesichert; volume-scale.json verhindert erneute Umrechnung. Die Regler bleiben danach frei bis 100 % nutzbar.

Hauptpegel und Mute werden auch während Pausen gespeichert und vor Wiedergabe nach Neuanlage des Ausgangs wiederhergestellt. Während activate.py die Zuordnung und Pegel wiederherstellt, blockiert eine Laufzeitmarkierung die Audiofreigabe. Falls die Aktivierung scheitert, bleibt die Ausgabe gesperrt, bis die Aktivierung erfolgreich wiederholt wird. Die bisherige Schutzdämpfung bleibt nicht als versteckte Begrenzung.

Prüfung und Rückweg

python3 verify.py und python3 verify-multiroom.py prüfen unter anderem Gruppen- identität, Erreichbarkeit, Beschränkung auf die aktive Sitzung, wiederholte Pegel, exakte PCM-Stille, Persistenz, beschädigte Dateien und Auswahlgrenzen. python3 branding-check.py bundle . prüft das ausgelieferte Branding.

Zum Rückweg die vorherigen Dateien aus der datierten Installationssicherung wieder installieren und den ergänzten Dienst gezielt neu starten; den zuvor gesicherten Ausgabezustand berücksichtigen. Neue Dateien sind in previously-absent.json aufgeführt. Persönliche Auswahl nicht pauschal löschen. Globale Autostartänderungen nur entsprechend autostart-before.txt rückgängig machen. Kein Zurücksetzen von PipeWire, Desktop, Mikrofonen oder Home-Gruppen. Bei Rückkehr zu einer Version mit fester −21-dB-Dämpfung die unterschiedliche Lautstärkeskala berücksichtigen; alte Reglerstände nicht ungeprüft über zwischenzeitliche Benutzeränderungen schreiben.

Quellen und Lizenzen

ENZCOM-Integrationsskripte: MIT, siehe LICENSE. cliairplay 0.5.8: GPL-3.0, wird separat vom Herstellerprojekt mit festen Prüfsummen heruntergeladen und behält seine Herstellerkennung. Lizenz und Drittanbieterhinweise werden neben dem Programm unter /opt/enzcom-airplay/0.5.8/ installiert. https://github.com/music-assistant/airplay-cli/tree/v0.5.8 Das Quellpaket enthält keine persönlichen Gerätekennungen oder Zugangsdaten.