Skip to content

FreeKiosk - Open-Source Android Kiosk Mode & Tablet Lockdown App for Digital Signage, Dashboards, POS & Single-Purpose Devices. Free Alternative to Fully Kiosk

License

Notifications You must be signed in to change notification settings

RushB-fr/freekiosk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

44 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

FreeKiosk

Free open-source kiosk mode for Android tablets

Alternative to Fully Kiosk Browser

Website โ€ข Installation โ€ข FAQ โ€ข Features

Version 1.2.9 Downloads License: MIT Android 8.0+ Device Owner REST API MQTT

A Rushb Project


๐Ÿš€ What is FreeKiosk?

FreeKiosk is a completely free and open-source kiosk mode application for Android tablets. It's the perfect alternative to expensive commercial solutions.

Built by Rushb, a French tech company passionate about creating innovative open-source solutions.

Why FreeKiosk?

  • โœ… 100% Free - No hidden fees, no subscriptions
  • โœ… Open Source - MIT Licensed, fully auditable
  • โœ… No Tracking - Your privacy matters
  • โœ… Device Owner Support - Complete lockdown mode
  • โœ… Optional Screen Pinning - User choice: full lock or normal mode
  • โœ… HTTPS Support - Works with self-signed certificates
  • โœ… Easy Setup - One-time ADB command
  • โœ… Home Assistant Ready - REST API + MQTT with auto-discovery

โœจ Features

Core Features

  • Full Kiosk Browser Mode with Android Device Owner API
  • External App Mode (Beta) - Lock any Android app instead of a WebView
  • Optional Screen Pinning - Choose between full lock or normal mode
  • WebView Display for any URL (dashboards, websites, etc.)
  • HTTPS Support - Including self-signed certificates
  • Password Protection - Default: Numeric PIN (4-6 digits). Optional: Advanced mode with alphanumeric passwords (letters, numbers, special characters)
  • Immersive Fullscreen - No navigation/status bars
  • Reset Settings - Clear configuration from within the app
  • Exit Kiosk Mode with restrictions deactivation

REST API (Home Assistant Ready) ๐Ÿ†•

  • 40+ Endpoints - Full device control via HTTP
  • Sensors: Battery, brightness, light, proximity, storage, memory, WiFi
  • Controls: Screen on/off, brightness, volume, navigation, reload
  • Audio: Play sounds, TTS, beep notifications
  • Screenshot: Capture screen as PNG image
  • Camera Photo: Take photos via front/back camera as JPEG
  • Remote Control: Android TV navigation (D-pad, back, home, etc.)
  • Optional API Key authentication
  • Full API Documentation

MQTT (Home Assistant Auto-Discovery) ๐Ÿ†•

  • 27 Entities auto-discovered in Home Assistant via MQTT Discovery
  • Sensors: Battery, brightness, light, WiFi SSID/signal, IP, memory, storage, volume, URL, app version
  • Binary Sensors: Screen on/off, screensaver, charging, kiosk mode, device owner, motion
  • Controls: Brightness slider, volume slider, screen power switch, screensaver switch
  • Buttons: Reload, wake, reboot, clear cache, lock
  • Text: Navigate to URL
  • Additional Commands: TTS, toast, audio play/stop/beep, launch app, execute JS, URL rotation
  • Push-based: Real-time status updates (configurable interval, default 30s)
  • LWT: Automatic availability tracking (online/offline)
  • Auto-reconnect: Handles WiFi drops and broker restarts
  • Always-on Motion Detection: Optional camera-based motion sensor
  • Full MQTT Documentation

ADB / CLI Configuration

  • Headless Provisioning - Configure via ADB without touching the screen
  • Mass Deployment - Script deployment across multiple devices
  • Full Config Support - URL, app lock, REST API, screensaver, etc.
  • Secure - PIN required (first setup or modification)
  • Full ADB Configuration Guide

Device Owner Mode (Advanced)

  • Complete Device Lockdown
  • Auto-start on Boot - Launch automatically
  • System App Suspension (Samsung bloatware, etc.)
  • Notification Blocking
  • Home Button Disabled
  • Recent Apps Disabled
  • Settings Access Blocked
  • Status Bar Hidden

External App Mode (Beta)

  • Launch Any App - Select from installed apps picker
  • 5-Tap Anywhere - Tap 5 times rapidly anywhere on screen to access settings (no corner targeting needed)
  • Optional Visual Indicator - Show bottom-right indicator (5-tap works everywhere regardless)
  • Auto-Relaunch - Automatically restart app on Home/Back press
  • Lock Task Support - Full kiosk lockdown for external apps
  • PIN Protection - Require PIN to access settings
  • Test Mode - Safety back button (enabled by default)
  • Blocking Overlay - Touch Logger with countdown and coordinate display

Flexibility

  • Toggle Screen Pinning ON/OFF - User decides the security level
  • Default OFF - Non-intrusive by default
  • In-app Reset - Clear settings without ADB access

๐Ÿ“ฑ Perfect For

  • ๐Ÿ  Home Assistant Dashboards
  • ๐Ÿจ Hotel Information Displays
  • ๐Ÿฝ๏ธ Restaurant Digital Menus
  • ๐Ÿช Retail Point of Sale
  • ๐ŸŽจ Museum Exhibits
  • ๐Ÿ“Š Digital Signage
  • ๐ŸŽฎ Event Check-in Stations
  • ๐Ÿฅ Healthcare Kiosks
  • ๐Ÿš† Transportation Info Boards

๐Ÿ“ฅ Installation

Quick Install (Basic Mode)

  1. Download the latest APK from Releases
  2. Install on your Android tablet (8.0+)
  3. Configure your URL and PIN in settings
  4. Optional: Enable "Pin App to Screen" for full lockdown
  5. Start kiosk mode

โš ๏ธ Basic mode allows some system interactions (swipe to exit).


Advanced Install (Device Owner Mode) - Recommended

For complete lockdown with full security, follow these steps:

Requirements

  • Android 8.0+ tablet
  • Windows/Mac/Linux PC
  • USB cable
  • ADB installed (Download)

Steps

1. Factory Reset your tablet

  • Settings โ†’ System โ†’ Reset โ†’ Factory reset
  • โš ๏ธ IMPORTANT: DO NOT add Google account after reset

2. Enable USB Debugging

  • Settings โ†’ About tablet โ†’ Tap "Build number" 7 times
  • Settings โ†’ Developer options โ†’ Enable "USB debugging"

3. Install FreeKiosk

  • Transfer APK to tablet or download from Releases
  • Install the APK

4. Activate Device Owner (on PC)

Connect tablet to PC via USB, then run:

adb shell dpm set-device-owner com.freekiosk/.DeviceAdminReceiver

text

You should see: Success: Device owner set to package com.freekiosk

text

5. Configure FreeKiosk

Option A: Via UI

  • Launch FreeKiosk
  • Tap 5 times anywhere on the screen (optional visual indicator available)
  • Enter default PIN: 1234
  • Configure your URL
  • Optional: Enable "Pin App to Screen" for full lockdown
  • Save settings

Option B: Via ADB (Headless Provisioning) ๐Ÿ†•

# Configure and lock to external app
adb shell am start -n com.freekiosk/.MainActivity \
    --es lock_package "com.example.myapp" \
    --es pin "1234"

# Or configure WebView URL
adb shell am start -n com.freekiosk/.MainActivity \
    --es url "https://your-dashboard.com" \
    --es pin "1234"

๐Ÿ“– Full ADB Configuration Guide

Done! Your tablet is now in kiosk mode.

๐Ÿ“– Full installation guide


โš™๏ธ Configuration

First Launch

  1. Tap 5 times anywhere on the screen (optional visual indicator available)
  2. Enter PIN (default: 1234)
  3. Access Settings screen

Settings Options

  • ๐ŸŒ URL to Display - Your dashboard/website URL
  • ๐Ÿ” PIN Code - 4-6 digit security code (change from default!)
  • ๐Ÿ“Œ Pin App to Screen - Toggle ON for full lockdown, OFF for normal mode
  • ๐Ÿ”„ Automatic Reload - Auto-reload page on error
  • ๐Ÿ“Š Show Status Bar - Display battery, WiFi, Bluetooth, and system icons
  • ๐Ÿงช Test Mode - Enable back button in External App Mode (default: ON)
  • ๐Ÿ”„ Reset All Settings - Clear configuration (useful in Device Owner mode)
  • ๐Ÿšช Exit Kiosk Mode - Close app and disable restrictions

Screen Pinning Modes

OFF (Default)

  • User can swipe up to exit
  • Normal Android navigation
  • Good for: trusted environments, testing

ON (Full Lockdown - requires Device Owner)

  • All gestures blocked
  • Recent apps disabled
  • Status bar hidden
  • Only 5-tap anywhere on screen + PIN allows exit
  • Good for: public kiosks, unattended devices

๐Ÿ†š vs Fully Kiosk Browser

Feature FreeKiosk Fully Kiosk
Price ๐ŸŸข Free ๐Ÿ”ด โ‚ฌ7.90/device
Open-source ๐ŸŸข MIT ๐Ÿ”ด Closed
Device Owner โœ… โœ…
REST API โœ… 40+ endpoints โœ…
MQTT + HA Discovery โœ… 27 entities โŒ
Home Assistant โœ… โœ…
Sensors (light, proximity) โœ… โœ…
Screenshot API โœ… โœ…
Audio playback โœ… โœ…
Remote control โœ… โœ…
HTTPS Self-signed โœ… โš ๏ธ
In-app Reset โœ… โš ๏ธ
Auto-start โœ… โœ…
Camera photo API โœ… โœ…
Cloud MDM Roadmap โœ…

๐Ÿ› ๏ธ Tech Stack

  • React Native 0.75+ with TypeScript
  • Kotlin native modules for Device Owner API
  • Android SDK 26+ (Android 8.0+)
  • WebView with custom SSL handling

๐Ÿ—บ๏ธ Roadmap

โœ… v1.2.13 (Feb 2026) - MQTT & Home Assistant Integration ๐Ÿ†•

  • ๐Ÿ“ก MQTT + Home Assistant Auto-Discovery: 27 auto-discovered HA entities (sensors, switches, buttons, controls)
  • ๐Ÿ“ก Push-based status: Periodic state publishing, LWT availability tracking, auto-reconnect
  • ๐Ÿ“ก 20 MQTT commands: TTS, toast, audio, launch app, execute JS, URL rotation, restart UI, and more
  • ๐Ÿ”Š Samsung Audio Fix: Fixed audio muted in Lock Mode on Samsung/OneUI devices
  • ๐Ÿ”ง Fire OS Camera/Mic Fix: Auto-grant WebView media permissions on Echo Show / Fire tablets

โœ… v1.2.12 (Feb 2026) - PDF Viewer, Accessibility & Screen Lock

  • ๐Ÿ“„ Inline PDF Viewer: PDFs open directly in-app via bundled PDF.js โ€” no Google Docs needed
  • โ™ฟ AccessibilityService: Cross-app keyboard injection for External App mode (privacy ROM compatible)
  • ๐Ÿ”’ Screen Lock without Device Owner: 4-tier fallback (Device Owner โ†’ Device Admin โ†’ Accessibility โ†’ dim)
  • ๐Ÿ”‘ Key Injection Fix: Replaced Instrumentation with dispatchKeyEvent() for privacy ROM compatibility

โœ… v1.2.11 (Feb 2026) - Keyboard API, GPS, TTS & Major Fixes

  • โŒจ๏ธ Keyboard Emulation API: Full keyboard input, shortcuts & text typing via REST
  • ๐Ÿ“ GPS Location API: Device coordinates via /api/location
  • ๐Ÿ”‹ Enriched Battery API: Temperature, voltage, health & technology fields
  • ๐Ÿ”’ Lock Device API & ๐Ÿ”„ Restart UI API: New remote control endpoints
  • ๐Ÿ—ฃ๏ธ Text-to-Speech (TTS): Native Android TTS via REST API
  • ๐Ÿ“Š Volume Read API: Current volume level via /api/volume
  • ๐Ÿ› Screen Sleep Scheduler Fix: Fixed black screen, lockout & wake-on-touch bugs
  • ๐Ÿ› Power Menu Fix (TECNO/HiOS): Fixed power menu dismissed immediately
  • ๐Ÿงน Clear Cache Fix: Now performs full native cache clear
  • ๐Ÿ”„ Update 404 Fix: Retrieves actual APK URL from GitHub assets

โœ… v1.2.10 (Feb 2026) - URL Filtering, NFC Fix & Scroll to Top

  • โฑ๏ธ Inactivity Return - Scroll to Top: Smoothly scrolls to top when already on start page
  • ๐Ÿ”— URL Filtering (Blacklist / Whitelist): Control allowed URLs with wildcard patterns
  • ๐Ÿ”— URL Filtering Form Fix: Fixed form submissions blocked in whitelist mode
  • ๐Ÿ“ก NFC Monitoring Fix: Fixed relaunch loop when NFC is enabled
  • ๐Ÿ’พ Backup/Restore Fix: Added 20 missing settings keys to export/import

โœ… v1.2.9 (Feb 2026) - Status Bar & Lock Mode Fixes

  • ๐Ÿ“ฑ Status Bar Rotation Fix: Fixed custom status bar disappearing after screen rotation in external app mode
  • ๐Ÿ”ง Lock Mode False Warning Fix: Fixed "Device Owner not configured" false warning due to JS/native method signature mismatch

โœ… v1.2.8 (Feb 2026) - Print, URL Filtering & Boot Fixes

  • ๐Ÿ–จ๏ธ WebView Print Support: Native Android printing via window.print() interception
    • Supports all connected printers (WiFi, Bluetooth, USB, Cloud Print, PDF)
  • ๐Ÿ”— URL Filtering (Blacklist / Whitelist): Control which URLs users can navigate to
    • Blacklist or Whitelist mode with wildcard pattern support
    • Works with traditional navigation and SPA/client-side routing
  • โฌ…๏ธ Back Button Mode via ADB: back_button_mode parameter synced to native SharedPreferences
  • โš ๏ธ Usage Stats Permission Warning: Permission check and grant button in Settings
  • ๐Ÿ”ง Back Button Fix: Fixed back button completely blocked when test_mode=false
  • ๐Ÿ”€ ADB Config Fix: lock_package now takes priority over url for display mode
  • ๐Ÿ”„ Auto Launch on Boot Fix: Fixed wrong AsyncStorage database name in native Kotlin files
  • ๐Ÿ”’ Settings Buttons Fix: Lock task temporarily stopped before opening system settings

โœ… v1.2.7 (Feb 2026) - Navigation Lock Fix

  • ๐Ÿ”’ Navigation Buttons Blocked in Lock Mode: Fixed Home/Recents buttons not properly blocked in kiosk lock mode
    • LOCK_TASK_FEATURE_NONE correctly blocks all system navigation by default
    • Updated hideSystemUI() to modern WindowInsetsController API for Android 11+

โœ… v1.2.6 (Feb 2026) - Screen Sleep Scheduler, Inactivity Return & Improvements

  • ๐Ÿ  Inactivity Return to Home: Auto-navigate back to start page after inactivity timeout
    • Configurable timeout (5โ€“3600 seconds), resets on touch/scroll/click
    • Option to clear cache on return and reset timer on new page load
    • Smart detection: paused during Screensaver, URL Rotation, and URL Planner
  • ๐ŸŒ™ Screen Sleep Scheduler: Automatically turn off screen during scheduled time periods
    • Multiple schedule rules with custom names, specific days, sleep/wake times
    • Supports midnight-crossing schedules with AlarmManager integration
    • Wake on touch option and PIN bypass for automatic wake-up
  • ๐Ÿ” Background App Monitoring: Auto-relaunch monitoring for External App mode
  • ๐Ÿ”„ Update Installation on Samsung Devices: Silent install via PackageInstaller API with auto-restart
  • ๐Ÿš€ ADB Configuration Kiosk Mode: Fixed kiosk mode not activating on first launch
  • ๐ŸŒ REST API Reboot Endpoint: Fixed reboot via native DevicePolicyManager
  • ๐Ÿ”€ REST API Method Handling: Control endpoints now accept both GET and POST

โœ… v1.2.5 (Feb 2026) - Camera API & Screen State Improvements

  • ๐Ÿ“ท Camera Photo API: Take photos via REST endpoint using device cameras
    • GET /api/camera/photo?camera=back&quality=80 - Capture JPEG photo
    • GET /api/camera/list - List available cameras with capabilities
    • Supports front and back cameras with configurable JPEG quality (1-100)
    • Auto-exposure and auto-focus warmup for optimal photo quality
    • Optimized resolution (~1.2MP) for fast HTTP transfer
    • Compatible with Home Assistant camera platform integration
  • ๐Ÿ–ผ๏ธ Screensaver API State Separation: Clarified screen status reporting
    • "on": Reports PHYSICAL screen state (PowerManager.isInteractive)
    • "screensaverActive": Separate boolean for screensaver overlay state
    • Allows clients to distinguish: screen physically on vs content visible to user
  • ๐Ÿ”ข Dynamic Version Reporting: API now reads version from BuildConfig
    • Automatically syncs with versionName in build.gradle
    • No manual updates needed when version changes

โœ… v1.2.4 (Feb 2026) - HTTP Server Reliability

  • ๐Ÿ“ก HTTP Server Screen-Off Availability: Fixed server becoming unreachable when screen is off
    • Added WifiLock (WIFI_MODE_FULL_HIGH_PERF) to prevent WiFi from sleeping
    • Added PARTIAL_WAKE_LOCK to keep CPU active for background HTTP processing
    • Server now remains accessible 24/7 regardless of screen state
    • Locks are automatically released when server stops to preserve battery
  • ๐Ÿ”’ Blocking Overlay: Bug fixes for blocking overlay display and behavior
  • ๐Ÿ”„ Auto Relaunch External App: Bug fixes for automatic external app relaunching

โœ… v1.2.3 (Jan 2026) - Auto Brightness & Security Improvements

  • ๐Ÿ“ท Motion Detection Camera Selection: Choose which camera to use for motion detection (front/back)
  • ๐Ÿ”˜ Flexible PIN Access Button: Choose between fixed corner button or tap-anywhere mode for accessing settings
  • โฌ…๏ธ WebView Back Button: Optional back navigation button in WebView for easier browsing
  • โ˜€๏ธ Auto Brightness: Automatic brightness adjustment based on ambient light sensor
  • ๐Ÿ” Enhanced PIN System: Improved PIN mode with advanced password option
  • ๐Ÿ”’ REST API Key Security: API key now stored in Android Keychain (encrypted) with automatic migration
  • ๐Ÿ”ง Bug Fixes: Fixed blocking overlay display issues and auto-update reliability

โœ… v1.2.2 (Jan 2026) - Volume 5-Tap & Screen Control Fixes

  • ๐Ÿ”Š Volume 5-Tap Gesture: Alternative to shake for accessing PIN screen
    • Press Volume Up/Down 5 times quickly to access settings
    • Works when volume is at max or min
    • Only active when kiosk mode is enabled
  • ๐Ÿ–ฅ๏ธ Screen On/Off API Fix: Improved reliability for Device Owner and non-Device Owner modes
  • ๐Ÿ”ง React Native New Architecture: Fixed compatibility with BroadcastReceivers

โœ… v1.2.1 (Jan 2026) - ADB Configuration & Headless Provisioning

  • ๐Ÿ”Œ ADB Configuration Support: Configure FreeKiosk via command line for automated deployment
  • ๐Ÿ“ฆ Headless Provisioning: Set locked app, URL, and all settings without UI interaction
  • ๐Ÿš€ Auto-restart & Launch: Automatically restart and launch external app after configuration
  • ๐Ÿ“ JSON & Parameter Support: Full JSON config or individual parameters via ADB
  • ๐Ÿ› ๏ธ Mass Deployment Ready: Perfect for CI/CD and enterprise provisioning
  • ๐Ÿ’พ Backup & Restore: Export/import complete FreeKiosk configuration to/from JSON file
  • ๐Ÿ”Œ Allow Power Button: New security setting to allow power menu access in Lock Mode
  • ๐Ÿ”ง REST API Fixes: Improved server stability and error handling
  • ๐Ÿ“– ADB Configuration Guide with examples and scripts

โœ… v1.2.0 (Jan 2026) - UI Redesign, URL Management & REST API

  • ๐ŸŽจ Complete Settings UI Redesign: Modern Material Design with 4 organized tabs (General, Display, Security, Advanced)
  • ๐Ÿ”„ URL Rotation: Automatically cycle through multiple URLs at configurable intervals
  • ๐Ÿ“… URL Planner: Schedule URLs based on time/date with recurring and one-time events
  • ๐ŸŒ REST API Server: Built-in HTTP server for Home Assistant integration
  • ๐Ÿ“ก 40+ Endpoints: Complete device control via HTTP
  • ๐Ÿ“Š Sensor Endpoints: Battery, brightness, light, proximity, storage, memory, WiFi
  • ๐ŸŽฎ Control Endpoints: Screen on/off, brightness, volume, navigation, reload
  • ๐Ÿ”Š Audio Endpoints: Play URL, stop, beep sound
  • ๐Ÿ“ธ Screenshot Endpoint: Capture screen as PNG
  • ๐Ÿ“บ Remote Control: Android TV navigation (D-pad, back, home, menu, play/pause)
  • ๐Ÿ” API Key Authentication: Optional security
  • ๐Ÿ“ Full API Documentation

โœ… v1.1.4 (Dec 2025)

  • ๐Ÿ”„ In-App Direct Update: Update FreeKiosk directly from within the app (Device Owner mode)
  • ๐ŸŽจ Status Bar Item Selection: Show/hide individual items (Home, Time, Battery, WiFi, Bluetooth, Sound)
  • ๐Ÿงช Test Mode Options: Three test modes for External App (Test Mode, Immediate Return, Delayed Return)
  • ๐Ÿ› Status Bar Position: Fixed status bar now properly sticks to the top in External App mode
  • ๐Ÿ› Clock Visibility: Fixed time display issue

โœ… v1.1.3 (Dec 2025)

  • โŒจ๏ธ Keyboard Mode: Default, Force Numeric, or Smart Detection
  • ๐Ÿ“Š Status Bar in External Mode: Choose to display on external app overlay and/or return screen
  • ๐Ÿ› Status Bar System: Debug and stability fixes
  • ๐Ÿ› PIN Code Max Attempts: Fixed counter issue

โœ… v1.1.2 (Dec 2025)

  • ๐Ÿ“Š Status Bar Display: New option to show/hide Android status bar (battery, WiFi, Bluetooth, sound)
  • ๐Ÿงช Test Mode for External App: Safety feature with back button (enabled by default)

โœ… v1.1.1 (Dec 2025)

  • ๐Ÿ‘๏ธ Overlay Button Visibility Toggle: Show/hide return button in External App Mode
  • ๐Ÿ—‘๏ธ Device Owner Removal: Easy removal of Device Owner privileges for uninstallation
  • ๐Ÿ”ข Configurable PIN Attempts: Set maximum attempts (1-100) with 15min lockout
  • ๐Ÿ› Critical Fix: PIN attempts now auto-reset after 1 hour of inactivity
  • ๐Ÿ› Critical Fix: Expired PIN attempts properly persisted to storage

โœ… v1.1.0 (Dec 2025)

  • ๐Ÿ“ฑ External App Mode (Beta): Launch and lock any Android app instead of a WebView
  • ๐Ÿ”’ Enhanced Lock Task: Whitelisted external apps in lock task mode
  • ๐ŸŽฏ Auto-relaunch: Configurable automatic app restart on exit attempts
  • ๐Ÿ› Potential fix for infinite loading on login pages (cookie/session handling)
  • ๐Ÿ› Lock task mode stability improvements

โœ… v1.0.5 (Nov 2025)

  • ๐ŸŽฅ Motion detection (Beta): Camera-based motion detection to exit screensaver mode
  • ๐Ÿช Cookie management: Basic cookie handling via react-native-cookies for web session persistence
  • ๐Ÿš€ WebView optimization: Performance improvements specifically for Fire OS tablets
  • ๐Ÿ”’ Enhanced WebView security: Additional security measures for safe web content display
  • ๐Ÿ› WebView stability improvements on Fire OS devices

โœ… v1.0.4 (Nov 2025)

  • ๐Ÿ”† Brightness control: Adjustable screen brightness slider in settings
  • ๐ŸŒ™ Screensaver mode: Configurable inactivity timer that dims screen to save power
  • ๐ŸŽฅ Added CAMERA permission for web apps needing camera access
  • ๐ŸŽค Added RECORD_AUDIO permission for web apps with audio features
  • ๐Ÿ“ Added ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions for location-based web apps
  • ๐Ÿ“ Added READ_EXTERNAL_STORAGE and WRITE_EXTERNAL_STORAGE permissions for file access support

โœ… v1.0.3 (Nov 2025)

  • โœ… Auto-launch toggle: Enable/disable automatic app launch at device boot
  • โœ… Screen always-on feature: Keep screen awake while app is running
  • โœ… Improved Device Owner auto-launch handling

โœ… v1.0.2 (Nov 2025)

  • โœ… Configuration access button on main screen
  • โœ… HTTPS self-signed certificate security prompt
  • โœ… Clear trusted certificates in reset settings
  • โœ… Improved Play Store compliance for SSL

โœ… v1.0.1 (Oct 2025)

  • โœ… Initial public release
  • โœ… Full kiosk mode with Device Owner support
  • โœ… Optional screen pinning toggle (ON/OFF in settings)
  • โœ… WebView display for any URL
  • โœ… HTTPS self-signed certificate support
  • โœ… PIN code protection (4-6 digits configurable)
  • โœ… Reset settings button
  • โœ… Auto-start on device boot
  • โœ… Samsung popup blocking (Device Owner mode)
  • โœ… Immersive fullscreen mode
  • โœ… Lock task mode support
  • โœ… System apps suspension (Device Owner mode)
  • โœ… English language UI

v1.3.0 (Q1 2026)

  • ๐Ÿ“ท Camera Photo API - Take photos via REST endpoint
  • ๐Ÿ”† Auto-brightness - Adjust brightness based on light sensor
  • ๐Ÿ“ฒ QR Code Config - Scan QR to configure app settings
  • ๐Ÿ’พ Backup/Restore - Export and import configuration
  • ๐ŸŽค Acoustic Wake - Voice detection to wake from screensaver
  • ๐Ÿ”” Webhook Events - Send events (motion, tap, battery) to URL
  • ๐ŸŽฌ Media Player - Play videos, images, playlists (digital signage)

v2.0.0 (Q2 2026) - FreeKiosk Cloud

  • โ˜๏ธ FreeKiosk Cloud - MDM Dashboard for fleet management
  • ๐Ÿ“ฑ Multi-device management - Control all tablets from one place
  • โš™๏ธ Remote configuration - Push settings to devices remotely
  • ๐Ÿ“Š Analytics & monitoring - Usage stats, health checks, alerts
  • ๐Ÿ”„ OTA Updates - Deploy app updates to all devices
  • ๐Ÿ‘ฅ User management - Roles and permissions
  • ๐Ÿข Organization support - Multi-tenant for businesses
  • ๐Ÿ“ก Device groups - Organize devices by location/function

v2.5.0 (Q4 2026) - Integrations

  • ๐Ÿ  HACS Integration - Native Home Assistant plugin
  • ๐ŸŒ Multi-language - French, Spanish, German, Portuguese
  • ๐ŸŽจ Custom Themes - Personalize UI colors and branding
  • ๐Ÿ“ก MQTT Support - Native MQTT with Home Assistant Auto-Discovery (27 entities)
  • ๐Ÿ”— Tasker Integration - Android automation support
  • ๐Ÿ“บ Chromecast Support - Cast content to displays
  • ๐ŸŽฎ Physical Button Remapping - Reassign device buttons (volume, camera, custom) to custom actions

๐Ÿ”ง Development

Prerequisites

  • Node.js 18+
  • React Native CLI
  • Android Studio
  • JDK 17+

Setup

Clone repository git clone https://github.com/rushb-fr/freekiosk.git cd freekiosk

Install dependencies npm install

Android setup cd android gradlew clean

Run on device npx react-native run-android

text

Build Release APK

cd android gradlew assembleRelease

APK location: android/app/build/outputs/apk/release/app-release.apk text


๐Ÿค Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to Contribute

  • ๐Ÿ› Report bugs via Issues
  • ๐Ÿ’ก Suggest features
  • ๐Ÿ”ง Submit pull requests
  • ๐Ÿ“– Improve documentation
  • ๐ŸŒ Translate to other languages
  • โญ Star the project!

Contributors


๐Ÿ› Known Issues

  • Factory reset required to remove Device Owner (Android limitation)
  • Some Samsung devices may require additional ADB permissions

See Issues for full list.


๐Ÿ“„ License

MIT License - see LICENSE file for details.

Copyright (c) 2025 Rushb


๐Ÿข About Rushb

FreeKiosk is developed and maintained by Rushb, a French tech company specialized in innovative software solutions.

Other Rushb Projects:

  • More coming soon! ๐Ÿš€

Contact:


๐Ÿ™ Acknowledgments

  • Built with React Native
  • Thanks to the open-source community

๐Ÿ“Š Stats

Stars Forks Issues License

Made with โค๏ธ in France by Rushb

Website โ€ข GitHub โ€ข Contact โ€ข Download