# MotoKiosk 🏁
A lightweight web-kiosk wrapper for MX & Motorsport.
- 🔒 **Device Lockdown:** Prevents users from exiting the app.
- 🌐 **URL Pinning:** Hard-coded to 1 or 2 specific web views (e.g., Live-Timing).
- 🛠️ **Configurable:** Minimal setup for professional paddock use.
|
|
||
|---|---|---|
| .idea | ||
| AndroidAPK | ||
| app | ||
| gradle | ||
| .gitignore | ||
| appicon.png | ||
| build.gradle.kts | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| Marlinz_DS_trp_bg.png | ||
| README.md | ||
| settings.gradle.kts | ||
| tryout2.png | ||
MotoKiosk v1.1
A professional tablet kiosk solution for MSC.
Developed by Marlinz Digital Solutions · marlinz.de
Overview
MotoKiosk is an Android kiosk app that shows a single web experience (event schedule and legal disclaimer) on locked-down tablets. It is designed for public use with minimal setup: set as Home app, optionally enable screen pinning, and go.
Features
Security & access
- Kiosk mode: Uses Android Screen Pinning (
startLockTask) to reduce accidental exits. Optional; the app works without it when set as the default Home app. - Hidden admin: 5 rapid taps on the screen open the password overlay. No visible admin entry for end users.
- Password protection: Admin panel and settings are protected by a configurable password (default: 1234).
- Controlled exit: "Unlock / Exit" returns to the home screen and ends the app without triggering the lock screen. Admin panel is only closed via "Close".
- Escape hatch: "Android Einstellungen öffnen" in the admin panel opens system settings so the device can always be reconfigured.
UI (Slate-dark theme)
- Top bar: Quick links to event page and legal disclaimer (§), glass-style bar.
- Branding: Marlinz and MSC logos in the admin header.
- Theme: Dark background (#0F172A) for Lenovo Tab M11 and similar devices.
Admin tools
- URL: Set and change the start URL and switch between event / legal pages.
- Password: Change the admin password in the System Configuration panel.
- Cache: Clear WebView cache and history.
- Refresh: Reload the current page; admin panel stays open until you tap "Close".
- Back key: Closes overlays (info, password, settings, admin) or goes back in WebView; does not exit the app when there is no history.
Reliability
- Connection errors: If the main page fails to load, a "Verbindung wird aufgebaut..." message is shown and the page is retried automatically after 5 seconds.
- Boot: Optional auto-start after boot via
BootReceiver(subject to Android background-activity rules on Android 10+).
Installation & setup
- Build: Open the project in Android Studio and run Build > Build APK(s) (or
./gradlew assembleDebug). - Install the APK on the tablet (e.g.
adb install -r app/build/outputs/apk/debug/app-debug.apk). - Set as Home app: In Android settings, set MotoKiosk as the default Home/Launcher app so the device always returns to MotoKiosk when Home is pressed.
- Optional – Screen pinning: In Settings > Security > App pinning, enable pinning. Then in MotoKiosk, use the admin menu (5 taps + password) and optionally lock the app. Without Device Owner this requires a one-time "App fixieren?" confirmation.
- First use: Open MotoKiosk, tap 5 times, enter the admin password (default 1234), then configure URL and password if needed.
Tech stack
- Language: Kotlin
- UI: Material 3, CardView, fullscreen WebView
- Storage: SharedPreferences (MotoKioskSettings) for URL and admin password
- Min SDK: 28 · Target SDK: 36
Support
For support or customisation:
Marlinz Digital Solutions
Web: www.marlinz.de