README
Free open-source kiosk mode for Android tablets
Complete guides for deployment, automation, and integration
FreeKiosk is a free, open-source kiosk platform for Android tablets. It's designed for teams and individuals who need full device control without licensing costs.
Perfect for:
- Home Assistant dashboards
- Corporate information displays
- Cloud gaming kiosks (Steam Link, Xbox Cloud Gaming)
- Digital signage
- Hotel/restaurant tablets
- Industrial control panels
- 100% Free - No per-device costs, no subscriptions, MIT licensed
- Complete Lockdown - Device Owner mode for enterprise-grade security
- Multiple Modes - WebView, External App, Dashboard, Media Player
- Rich Automation - 40+ REST API endpoints + MQTT with Home Assistant auto-discovery
- Mass Deployment - ADB-based headless provisioning
- Privacy First - No tracking, no cloud dependencies
| Feature | FreeKiosk | Fully Kiosk |
|---|---|---|
| Price | Free | €7.90/device |
| Open Source | MIT | Closed |
| Device Owner | Yes | Yes |
| REST API | 40+ endpoints | Yes |
| MQTT + HA Discovery | Yes | No |
| Cloud Management | Roadmap | Yes |
- Download the latest APK from Releases
- Install on your Android 8.0+ tablet
- Configure URL and PIN
- Start kiosk mode
For complete lockdown with no system interruptions:
adb shell dpm set-device-owner com.freekiosk/.DeviceAdminReceiverTip
See the complete Installation Guide for detailed setup instructions.
| Guide | Description | Link |
|---|---|---|
| Installation | Complete setup guide from basic to Device Owner mode | Read → |
| Features & Modes | Understand WebView, External App, Dashboard modes | Read → |
| FAQ | Common questions and troubleshooting | Read → |
| Guide | Description | Link |
|---|---|---|
| Integrations Overview | Choose between REST API and MQTT | Read → |
| REST API | 40+ HTTP endpoints for device control | Read → |
| MQTT | Real-time telemetry and Home Assistant discovery | Read → |
| ADB Configuration | Headless provisioning and scripting | Read → |
| Guide | Description | Link |
|---|---|---|
| Development | Build and contribute to FreeKiosk | Read → |
| Roadmap & Changelog | Release notes and future plans | Read → |
| Wiki Sync | How documentation is published | Read → |
# Configure via ADB
adb shell am start -n com.freekiosk/.MainActivity \
--es url "https://homeassistant.local:8123" \
--es pin "1234" \
--es mqtt_enabled "true" \
--es mqtt_broker_url "192.168.1.100"# Lock to Steam Link with auto-relaunch
adb shell am start -n com.freekiosk/.MainActivity \
--es lock_package "com.valvesoftware.steamlink" \
--es pin "1234" \
--es test_mode "false" \
--ez auto_start true# Simple URL kiosk with REST API
adb shell am start -n com.freekiosk/.MainActivity \
--es url "https://dashboard.company.com" \
--es pin "0000" \
--es rest_api_enabled "true" \
--es rest_api_port "8080"- Website: freekiosk.app
- Releases: GitHub Releases
- Issues: Report Bugs
- Discussions: Community Forum
- Support: support@freekiosk.app
FreeKiosk is open source and welcomes contributions!
- Code: Contributing Guide
- Documentation: Submit PRs to improve these docs
- Feedback: Share your use case in Discussions
Made with ❤️ by Rushb