- Python 94.4%
- JavaScript 5.6%
|
|
||
|---|---|---|
| branding | ||
| defaults | ||
| panel | ||
| activate.py | ||
| airplay_settings.py | ||
| branding-check.py | ||
| branding-lock.json | ||
| configure-network.py | ||
| controls.py | ||
| de.enzcom.AirPlay.desktop | ||
| enzcom-airplay.service | ||
| group-output.py | ||
| install-group.py | ||
| install-ui.py | ||
| LICENSE | ||
| OS-INTEGRATION.md | ||
| README.md | ||
| verify-multiroom.py | ||
| verify-start.py | ||
| verify.py | ||
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.