Repository navigation
Releases
v1.2.0
1.2.0
Needs Kiosk Satellite 2026.11.16 or later.
- Uses far less memory under bad network traffic: at most 10 seconds of audio ahead, one AirPlay session at a time.
- The Shizuku Start button only appears while "Start Shizuku as root at boot" is on.
- Once Shizuku is running, ADB is switched back from root, so the network port no longer leads straight to root access.
- The boot start's key now lives in the plugin's own folder and is deleted if you uninstall the plugin.
- The PTP port redirect is now removed whenever the plugin stops.
- Smaller hardening of the PTP and remote-control code.
V1.1.0
1.1.0
- Audio offset is easier to set exactly: type a value in 0.01 s steps instead of using a slider.
- New − 0.01 s and + 0.01 s buttons under it nudge the offset one step at a time while you listen. Each tap applies and saves straight away.
1.0.1
1.0.1
With the substantial changes to V1 - some issues with Gen 1 HomePods crept back in.
- Fixed: Echos stuttered and dropped out after a first-generation HomePod joined a group, until restarted.
- Fixed: audio could overlap or skip when a speaker joined or left the group.
v1.0.0
⚠️ Big change: read before updating - This V1 release is the final release to be submitted as a proper KS Plugin
1.0 turns the plugin into a proper Kiosk Satellite player. Kiosk Satellite's own Now Playing, lyrics, ducking and echo cancellation now work with AirPlay, and the plugin has been hardened after a security review.
After updating:
- Update Kiosk Satellite to 2026.11.14 or later first. 1.0 won't run on older versions.
- Pick the plugin as your player: Settings > Media Player > Player > AirPlay 2. Until you do, the kiosk won't appear as an AirPlay speaker.
- Set up Now Playing, lyrics and ducking in Kiosk Satellite's Media Player settings. The plugin no longer draws its own players.
Your Shizuku setup, boot start, speaker name and audio offset carry over. The boot start keeps working with no new prompt.
What's new
- Plays through Kiosk Satellite's own audio output: Now Playing, the floating player, lyrics, media volume, assistant ducking and echo cancellation all work with AirPlay. Multi-room sync uses that output's timestamps.
- Only advertises while picked as the player, so the kiosk never shows up twice in the AirPlay menu.
- Track details, cover art and playback state reach Home Assistant through Kiosk Satellite's media player entity.
- No longer contacts any internet server.
Security and stability
- Nothing on the network can crash Kiosk Satellite through the plugin. Every plugin thread catches and logs whatever goes wrong.
- Sender data is parsed with strict limits, and connections and PTP clocks are capped, so crafted or spoofed traffic can't exhaust memory.
- Stopping the plugin is faster and no longer leaks a thread.
Boot start (optional, off by default)
- The plugin no longer changes system settings itself. New setups allow the plugin's key once on screen and run one setup command (see step 8 in the README).
- The ADB key now lives in private storage on each kiosk, never in settings, so exports and Fleet Management don't copy it.
- Turning the boot start off removes the plugin's key from Android's trusted ADB keys. The README explains how to undo everything by hand.
- Removed Shizuku start command. The plugin only runs Shizuku's own starter from its installed package.
Removed (Kiosk Satellite does these now)
- The plugin's floating player, full-screen player, screensaver view and lyrics
- Lower AirPlay while the assistant talks, and Wake the screen when playback starts
- The AirPlay receiver switch and the track, artist, album, source, volume and playing sensors
- The Play/pause, Next and Previous actions (they never worked with iPhones)
Other
- Added NOTICE: the ALAC decoder is ported from Apple's Apache-2.0 reference decoder.
Full details are in CHANGELOG.md.
0.7.0 – Kiosk Satellite player
⚠️ Big change: read before updating
0.7.0 turns the plugin into a proper Kiosk Satellite player. That's what Community Plugins listing needs, and it means Kiosk Satellite's own Now Playing, lyrics, ducking and echo cancellation now work with AirPlay.
After updating:
- Update Kiosk Satellite to 2026.11.14 or later first. 0.7.0 won't run on older versions.
- Pick the plugin as your player: Settings > Media Player > Player > AirPlay 2. Until you do, the kiosk won't appear as an AirPlay speaker.
- Set up Now Playing, lyrics and ducking in Kiosk Satellite's Media Player settings. The plugin no longer draws its own players.
Your Shizuku setup, boot start, speaker name and audio offset carry over unchanged.
What's new
- Plays through Kiosk Satellite's own audio output: its Now Playing view, floating player, lyrics, media volume, assistant ducking and echo cancellation all work with AirPlay. Multi-room sync uses that output's timestamps.
- Only advertises while picked as the player, so the kiosk never shows up twice in the AirPlay menu.
- Track details, cover art and playback state reach Home Assistant through Kiosk Satellite's media player entity.
- No longer contacts any internet server.
Removed (Kiosk Satellite does these now)
- The plugin's floating player, full-screen player, screensaver view and lyrics
- Lower AirPlay while the assistant talks, and Wake the screen when playback starts
- The AirPlay receiver switch and the track, artist, album, source, volume and playing sensors
- The Play/pause, Next and Previous actions (they never worked with iPhones)
0.6.6: Fix adding a first-generation HomePod to a playing group
- Fix: playing to kiosks first and then adding a first-generation HomePod still put them out of sync. The HomePod sends timing under the iPhone's clock ID but with its own time, days away, and the plugin mixed those readings with the iPhone's. Clocks are now kept apart per sender, and when two senders use one ID, the one whose time fits the audio's anchor is followed. The log names the sender.
To Replicate this issue, from an iPhone:
AirPlay to an Echo Kiosk, then add a Gen 1 HomePod - music is out of sync
Start with AirPlay to the Gen 1 HomePod, then add the Echo Kiosk, Music is in sync
0.6.5: Stay in sync when a HomePod joins
- Fix: kiosks still sometimes play out of sync, or dropped out, with a first-generation HomePod in the group. When the HomePod joins, the iPhone steps its clock by hours to follow it, and the plugin's smoothing let the clock move back only a fraction of a millisecond at a time. A jump of more than a second that two readings agree on is now taken at once, in either direction, and logged.
0.6.4: Fix groups with a first-generation HomePod
- Fix: adding a first-generation HomePod to a group made the kiosks drop out or play out of sync. The HomePod follows the iPhone's clock but sends its own time, hours away, and the plugin sometimes followed the HomePod instead of the iPhone. The clock the sender names now always comes first.
- The log says which PTP clock each timeline follows.
0.6.3: Each kiosk gets its own AirPlay identity
- Fix: with Fleet Management, the iPhone listed only one of the kiosks and grouped audio could go to the wrong one. The plugin saved a random AirPlay device ID as a setting, and the fleet copied the leader's to every kiosk. The ID is now made from each device, so every kiosk has its own. Apple devices see each kiosk as a new speaker once.
- AirPlay device ID under Advanced is now an optional override, empty by default.
- The boot start's ADB key setup retries when another root command was still running, instead of waiting for the next boot.
0.6.2: Stop the USB debugging prompt at every restart
- Fix: Android asked "Allow USB debugging?" at every restart, with a new fingerprint each time, and multi-room stayed off until someone answered. The plugin lost its ADB key at each restart. It now keeps it in a secret ADB key setting under Advanced, so Android asks once. Clear the setting to make a new key.
- At boot, if nobody answers the prompt, the plugin asks again every 30 seconds for up to ten minutes instead of giving up.
- The keys earlier versions left in Android's trusted ADB keys are removed.