Kiosk-First UX
Immersive fullscreen, keep-screen-on option, hidden admin gesture (top-right tap x5), and quick dashboard reload controls.
Android Kiosk Browser for Home Assistant
KioskZen
Built for wall tablets and dedicated dashboard screens. KioskZen gives you fullscreen reliability, better media compatibility with GeckoView, and practical security controls.
What You Get
Engine Choice
Switch between GeckoView, Android WebView, and Chromium-style profile from settings to match your dashboard behavior.
Recovery Built In
Automatic retry on network drops, process crashes, and page failures so wall dashboards recover without manual intervention.
Security & Privacy
Hardened Defaults
- Android backup export disabled
- Secure window mode enabled
- Permission grants restricted to trusted Home Assistant origin
- Safer WebView settings and blocked unsupported top-level schemes
Admin Access Protection
- Optional admin password gate before settings
- PBKDF2 salted password hashing
- Legacy hash values auto-migrate after successful login
Quick Setup
- Install the latest APK from Releases.
- Open hidden admin area (tap top-right corner 5 times).
- Set Home Assistant base URL and dashboard path.
- Choose your browser engine and enable optional kiosk toggles.
- Tap reload and mount the tablet.
Compatibility Notes
For dashboards using ?kiosk, install kiosk-mode via HACS in Home Assistant.
For best privacy, prefer https:// Home Assistant URLs whenever available.
FAQ
Many camera streams and media pipelines that fail in some WebView-based kiosks work better under GeckoView.
Yes, there is an auto-start-on-boot toggle in settings.
Yes. It works with local Home Assistant instances and LAN addresses/hostnames.
Parts of this codebase were built with AI-assisted tooling, then reviewed and adjusted manually.