Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[tarikweiss]

Aktuelle Test Version	0.0.1
Veröffentlichungsdatum	14.01.2026
Github Link	https://github.com/tarikweiss/ioBroker.airplay

Ich habe einen Adapter zum Abspielen von Audio-Files auf AirPlay fähigen Geräten gebaut. Dieser ist eine wirklich erste Version, um erstmal zu testen, was überhaupt mit AirPlay geht.

Diese Version kann mit Hilfe der "GitHub-Katze" installiert werden. Fügt dazu dann den Link von oben ein. (Die GitHub-Katze ist nur bei aktiviertem Expertenmodus sichtbar)

Vor der Installation bitte sicherstellen, dass das benötigte ffmpeg installiert ist!

Einrichtung

Der Adapter sucht automatisch via mDNS/dns-sd/Bonjour nach AirPlay-fähigen Geräten. Dazu ist es wichtig, dass der Adapter Zugriff auf euer Netzwerk hat (was vor allem bei Docker-Instanzen wichtig ist), da die Geräte sonst nicht auftauchen! Für weitere Informationen bzgl. Docker gerne unter https://hub.docker.com/r/iobroker/iobroker nachschlagen.

Nutzung

Wenn der Adapter eingerichtet wurde, dann tauchen alle Geräte unter dem devices Unterpunkt im Objektbaum auf.

Die Geräte können dann mit dem on-air Datenpunkt "live" geschaltet werden.

Wenn ein Passcode benötigt wird, dann ist dieses danach unter passcode einzugeben.

Wenn alles glatt läuft, kann man danach unter stream.file den Dateipfad angeben und die angegebene Datei sollte auf den "live" geschalteten Geräten zu hören sein. Ich empfehle den absoluten Dateipfad einzugeben.

Ihr könnte eine Datei in dem Dateien-Tab von ioBroker hochladen und diesen Dateipfad dann nutzen um die Datei abzuspielen. Es kann auch jeder andere verfügbare und lesbare Pfad genutzt werden.

Eine Pause/Stop Funktionalität gibt es derzeit (noch) nicht.

Mit dem volume Datenpunkt kann die Lautstärke gesetzt werden.

Technische Einschränkungen

Eine Audio-Datei kann nicht als "Overlay" abgespielt werden, wie man es möglicherweise von HomeKit Intercom kennt.

Wird von einem AirPlay-Endgerät die Lautstärke angepasst, welches sich in einem Stereo-Paar befindet (HomePods), dann wird von dem gesamten Stereo-Paar die Lautstärke angepasst.

Schlusswort

Viel Spaß beim Testen und danke für euer Feedback! Bei Fragen, einfach fragen ;)

[tarikweiss]

Hier noch ein kurze Kommentar / ein kurzes Skript dazu, wie man den Adapter praktischerweise mit sayit einsetzen kann:

sendTo('sayit.0', 'say', {
    text: 'Auf der Terasse ist es sehr glatt heute!'
});

setState('airplay.0.devices.XX:XX:XX:XX:XX:XX.on-air', true);
setState('airplay.0.devices.XX:XX:XX:XX:XX:XX.volume', 80);

setTimeout(() => {
    setState('airplay.0.stream.file', '/opt/iobroker/iobroker-data/sayit/sayit.0.say.mp3');
}, 1000);

[OliverIO]

@tarikweiss

Wie hoch ist der Versatz und Netzwerklast?
Der Logitech/Lyrion Musik Server hat ein Plugin um bspw von einem iOS Gerät an beliebige LMS Player zu streamen.
Versatz lag bei bis zu 20 Sekunden und netzwerklast war relativ hoch.
Bibliothek war damals shairport
https://github.com/mikebrady/shairport-sync
Hohe netzwerklast lag wahrscheinlich daran das shairport direkt pcm liefert und nicht nochmal in mp3 umwandelt.

[tarikweiss]

Zur tatsächlichen Last kann ich nicht viel sagen, er hat aber eine kurze Gedenksekunde, bevor er den Stream dann tatsächlich auch überträgt. Aber die sollte dann auch reichen. Ansonsten gern einfach herunterladen und testen.