Skip to content

0.5.0 — Audio output delay (AirPlay 2 sync)

Choose a tag to compare

@space192 space192 released this 12 Sep 17:30
· 8 commits to main since this release
v0.5.0
8872a3a

Adds an Audio Output Delay number entity that fixes AirPlay 2 group sync on the Zeppelin.

If your Zeppelin plays a fixed amount ahead of your other speakers in a mixed-brand AirPlay 2 group, the speaker over-reports its output latency and the sender ships audio too early. This release exposes the speaker's undocumented audioOutputDelay setting as a slider in Home Assistant: a negative value lowers the reported latency so the sender delays the audio and it lands back in sync.

What's new

  • Audio Output Delay number entity (ms, −1000 to +1000, step 10) under the Zeppelin device (Configuration category)
  • The current value is read from the speaker at startup and shown in Home Assistant — it survives power cycles
  • Talks to the speaker's local StreamSDK HTTP API on port 80 (/api/getData and /api/setData), separate from the StateD API on port 42425

Tuning

Set the slider to around −150 ms, stop and restart playback in your AirPlay 2 group, and bisect by ear in 10 ms steps. Set to 0 to revert to factory behaviour. Only fixes a consistent fixed offset — not random Wi-Fi drift.