Kiosk Satellite
2026.11.23 · GitHub
More about this app
Home Assistant kiosk: voice satellite, synchronized music and photo screensaver, with Shizuku used for privileged APK updates and device bridging.
Kiosk Satellite is an Android app designed for dedicated Home Assistant kiosks, with native Voice Satellite support, synchronized music playback and photo screensavers.
Kiosk Satellite is fully local and free for personal, non-commercial use.
Download · Get started · Documentation
Features
• Native voice control: Kiosk Satellite is a Home Assistant Assist satellite on its own, with Voice Satellite built in: ten skins, timers, announcements and wake word detection that works with the screen off or, with background listening enabled, while another app is open. Nothing to install in Home Assistant.
• Dashboard performance: Optional optimizations reduce unnecessary dashboard updates and pause rendering during screensavers to lower CPU and GPU usage on older devices. Voice and the Home Assistant connection stay active.
• Music playback: Synchronized Music Assistant audio through Sendspin, AirPlay from an iPhone, iPad or Mac and the option to follow a Home Assistant or Sonos player. The full-screen Now Playing view shows album art, playback controls and supported lyrics, and the Music Library browses Music Assistant, Home Assistant or Sonos and plays on any speaker.
• Screensavers: Immich albums, local photos, clocks, weather mood and a live night sky, with motion, face or presence detection to wake the kiosk.
• Motion, face and person detection: The device camera detects motion and faces on the device itself. Motion wakes the screen when someone walks up and holds off the screensaver while the room is in use. Face detection wakes it only when someone looks at the screen, so people walking past leave the screensaver up. Person detection uses the built-in sensor on supported devices. Motion and person also show up in Home Assistant as sensors for your automations.
• Home Assistant integration: The built-in ESPHome connection exposes screen controls, volume and device sensors. An optional Bluetooth proxy relays nearby Bluetooth devices to Home Assistant.
• Remote administration: Configure the app, view live screenshots, read logs and back up settings from a browser. Fleet management shares configuration profiles and coordinates updates across multiple kiosks.
• Intercom: Make voice or video calls between kiosks or broadcast to all kiosks at once using the Intercom feature. Kiosks are auto discovered in the local network.
• Alarms: Set alarms that ring on the kiosk itself, with no Home Assistant or network needed. A sunrise can brighten the screen before the alarm rings, and a Clock or Weather Mood screensaver can show the alarm with Snooze and Stop in its own style.
• Calendar: Show your Home Assistant calendars as a family calendar with Day, Week, Month and Schedule views. Each person gets a color, and an event shared by several people is split between their colors.
• Timers: Set timers by voice or by hand and follow them on a full screen view, with the next one to finish shown large. Shared timers also show and ring on the other kiosks you pick, with the countdown and the alert in sync.
• Kiosk conveniences: Use hand gestures to run Home Assistant actions or open a camera view by holding up fingers to the device camera. Set Kiosk Satellite as the home launcher on supported devices so the Home button returns to your dashboard. Arrange up to twelve live feeds in camera views, with camera imports from Home Assistant or Go2RTC.
Also built in: PIN-protected kiosk mode, touch and clap gestures, DLNA media playback, RTSP streaming, Shizuku support and more!
Get started
You need Android 7.0 or newer, a reachable Home Assistant instance and a long-lived access token from Home Assistant Profile → Security → Long-lived access tokens.
- Download the latest APK on your Android device.
- Open it to install. Allow installation from this source if Android asks.
- Launch Kiosk Satellite and follow the setup wizard to connect Home Assistant and choose your dashboard.
You can also enable Remote Administration in the first setup step and finish setup from your computer at http://<device-ip>:2324.
For voice control, leave Voice Satellite on in the setup wizard, then add the kiosk in Home Assistant under Settings > Devices & services, where it shows up as discovered. See Voice Satellite.
Documentation
Voice Satellite · Screensavers · Music · ESPHome & Bluetooth · Fleet management
All guides and API references
• **Display:** [Screen settings](https://kiosksatellite.com/docs/screen/), [custom pages](https://kiosksatellite.com/docs/custom-pages/), [screensavers](https://kiosksatellite.com/docs/screensavers/), [Immich](https://kiosksatellite.com/docs/immich/) and [At a Glance widgets](https://kiosksatellite.com/docs/at-a-glance/).• Voice and media: Voice Satellite, microphone, media player, camera views, device camera, intercom and DLNA.
• Kiosk setup: Lockdown, home launcher, gestures, LED control, alarms, optimizations, permissions, Shizuku and updates.
• Automation and management: ESPHome, fleet management, Remote API, TLS encryption and JavaScript API.
• Device guides: Amazon Fire tablets, Echo Dot (2nd gen), Echo Dot (3rd gen), Echo Show 5 (1st gen), Echo Show 5 (2nd gen), Echo Show 8 (1st gen), Echo Show 8 (2nd gen), Meta Portal and Raspberry Pi 4.
• Plugin Manager: Install and create community plugins for Kiosk Satellite.
Thank you to everyone who supports my work through Buy Me a Coffee. I test everything on real hardware, which means buying devices to reproduce issues and check changes across different manufacturers and Android flavors. Your contributions help cover those purchases and make that testing possible.
License and credits
Free for personal, non-commercial use under CC BY-NC-ND 4.0. Commercial use of the application and redistribution of modified application builds are not permitted. Independent plugins have additional permission.
Built with these projects
Thanks to [Home Assistant](https://www.home-assistant.io/), [ESPHome](https://esphome.io/), [Music Assistant](https://www.music-assistant.io/), [Immich](https://immich.app/), [Flutter](https://flutter.dev/), [flutter_inappwebview](https://inappwebview.dev/) and [ONNX Runtime](https://onnxruntime.ai/).Wake-word support builds on vsWakeWord, openWakeWord and microWakeWord. Echo cancellation uses LocalVQE and ggml, with WebRTC audio processing and Abseil as the fallback. Icons come from Material Design Icons. Fonts include Rubik, Nunito, Inter and DSEG.
Thank you to the package authors whose work makes Kiosk Satellite possible.
How Shizuku is used
Can silently install updates, grant permissions, restart, check identity and run shell commands via `pm install` and `sh -c` through Shizuku.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
Shizuku is used for silent privileged updates, device setup actions and shell commands on the kiosk.
- Install app updates silently: Installs the downloaded kiosk update with no on screen confirmation using the privileged install command through Shizuku.
- Grant device permissions: Grants microphone, camera, location, Bluetooth, notifications, display over apps, system settings, all files access, usage access, notification access, device admin and accessibility guard using privileged permission commands through Shizuku.
- Check connection identity: Runs a connection test that returns the helper identity using the system identity command through Shizuku.
- Restart the device: Restarts the kiosk using the system restart command through Shizuku, with a power manager command as fallback.
- Run custom shell commands: Runs a shell command line sent from Home Assistant, as
adb shellwould, and returns its exit code and output using the shell command runner through Shizuku. - Support installed plugins: Installed plugins with the declared capability can run their own device operations through Shizuku.
Android APIs or commands used
pm installpm grantappops setdumpsys deviceidle whitelistcmd notification allow_listenerdpm set-active-adminsettings getsettings putidrebootsvc power rebootsh -c
Notable details
Without Shizuku, updates use the normal Android installer session, with confirmation when required, or the ADB helper. Built in device actions use fixed commands for this app only; only the separate custom command action runs typed shell text from Home Assistant. Installed plugins share the same authorized connection and are not isolated from its privileges.
Changelog
What's new for version 2026.11.23
What's new in Kiosk Satellite 2026.11.23
This release adds a way to test the Adaptive volume curve without leaving the app. It also fixes the screensaver being hidden under dashboards that go fullscreen, ESPHome announcements ignoring Adaptive volume and Compass pulling the kiosk back over another app.
Improvements
- Test volume on the Adaptive volume page. Tuning the curve meant going to Home Assistant to send an announcement after every change. A new Test volume group under the curve has two buttons that play an announcement at the volume the room picks right now. Test Assistant volume plays a Voice Satellite announcement at the Assistant volume, and Test Media volume plays an ESPHome announcement at the Media volume. Each button needs its feature set up first: Voice Satellite in Home Assistant, or Announcements under ESPHome. Settings stay on screen, so the curve can be changed and tried again right away. Mirrored in the remote admin. See Adaptive Volume.
Fixes
- Screensaver hidden after a tap on the dashboard (#1461). A dashboard that asks for fullscreen on a tap, as Wallpanel does, was drawn above everything in Kiosk Satellite. After the first touch the screensaver started under the dashboard and the drawer opened hidden under it until the app restarted. The kiosk already fills the screen, so a request to put the whole page in fullscreen is now skipped. A video or another element can still go fullscreen, and it leaves fullscreen when the screensaver starts, back is pressed or Kiosk Satellite opens something over the dashboard.
- ESPHome announcements ignored Adaptive volume. An announcement from the
announceaction plays at the media volume, but it played at the full slider level in a quiet room. With the Media switch of Adaptive volume on, it now follows the room like music does. An announcement with avolumeset in the action keeps that volume. See Adaptive Volume. - Compass brought the kiosk back over another app (#1453). With Compass navigation, Return to center kept counting while an app opened from the kiosk was in front. Once it ran out, the center view opened and brought the kiosk back over that app, long before the App Launcher's Return after. Return to center now waits while another app is in front, and its countdown starts over once the kiosk is back.
Permissions
40 permissions requested
Sources
4 sources
Sources
4 sources









