Dokumentation

FreeKiosk Dokumentation

Alles, was Sie brauchen, um Ihren Kiosk einzurichten und zu konfigurieren

Überblick

FreeKiosk ist eine kostenlose Open-Source-App, die Android-Tablets in sichere Kioske verwandelt, die eine einzelne Website oder Web-App im Vollbild anzeigen. Ideal für Infodisplays, Kassensysteme, Digital Signage und öffentliche Terminals.

Was die App kann

  • WebView im Vollbild oder Externe App
  • REST-API (über 40 Endpunkte)
  • URL-Rotation & Planer
  • Vollständige Gerätesperre

Voraussetzungen

  • Android 8.0+ (Oreo)
  • Netzwerkverbindung
  • ADB (für Device Owner)

Installation

Einfache Installation

  1. 1

    APK herunterladen

    Auf unserer Download-Seite oder im Google Play Store

  2. 2

    Auf das Gerät übertragen

    Per USB, E-Mail oder direkten Download

  3. 3

    App installieren

    Aktivieren Sie bei Bedarf „Unbekannte Quellen“ unter Einstellungen > Sicherheit

  4. 4

    FreeKiosk öffnen

    URL und Einstellungen festlegen

FreeKiosk herunterladen

Device-Owner-Modus

Warum Device Owner?

Der Device-Owner-Modus bietet die vollständige Sperre: keine Statusleiste, keine Benachrichtigungen, keine Navigationstasten, automatischer Neustart bei einem Absturz und keine Möglichkeit für Nutzer, den Kiosk zu verlassen.

Voraussetzungen

  • Auf Werkseinstellungen zurückgesetztes Gerät (ohne Google-Konto)
  • ADB auf Ihrem Computer installiert
  • USB-Debugging auf dem Gerät aktiviert
  • FreeKiosk bereits installiert

Einrichtung Schritt für Schritt

Schritt 1: Zurücksetzen auf Werkseinstellungen

Öffnen Sie Einstellungen → System → Optionen zum Zurücksetzen → Alle Daten löschen

Fügen Sie bei der Ersteinrichtung KEIN Google-Konto hinzu. Überspringen Sie jede Kontoerstellung.

Schritt 2: Entwickleroptionen aktivieren
  1. Öffnen Sie Einstellungen → Über das Tablet
  2. Tippen Sie 7-mal auf Buildnummer
  3. Gehen Sie zurück zu Einstellungen → Entwickleroptionen
  4. Aktivieren Sie USB-Debugging
Schritt 3: FreeKiosk installieren

Installieren Sie die APK per USB-Übertragung, Web-Download oder SD-Karte. Achten Sie darauf, dass die App installiert ist, bevor Sie den ADB-Befehl ausführen.

Schritt 4: Device Owner festlegen

Verbinden Sie das Tablet per USB und führen Sie Folgendes aus:

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

Sie sollten Folgendes sehen: Success: Device owner set

Device-Owner-Modus entfernen

Um den Device-Owner-Status zu entfernen, öffnen Sie FreeKiosk-Einstellungen → Device Owner entfernen oder führen Sie Folgendes aus:

adb shell dpm remove-active-admin com.freekiosk/.DeviceAdminReceiver

Grundkonfiguration (Schnellstart)

1Ihre URL

Die URL, die das Tablet dauerhaft anzeigt.

https://freekiosk.app

2PIN-Code

4-6-stellige PIN für den Zugriff auf die Einstellungen.

3Empfohlener Modus

EinsatzModusBildschirmfixierung
🌐 WebseiteWebView✅ Aktiviert
📺 Externe AppExterne App✅ Aktiviert
🧪 Test / DemoWebView❌ Deaktiviert

4Wichtige Einstellungen

OptionEmpfohlener Wert
Vollbild✅ Aktiviert
Autostart beim Booten✅ Aktiviert
Statusleiste ausblenden✅ Aktiviert
Bildschirm-TimeoutNie (oder über den Bildschirmschoner)
Helligkeit50-70 %

5REST-API (optional)

Steuern Sie Ihr Tablet über Home Assistant.

Weitere Details finden Sie in der API-Dokumentation.

Funktionen

Vollständige Sperre

Kein Ausstieg ohne PIN-Code

REST-API

Über 40 Endpunkte für Home Assistant

URL-Rotation & Planer

URLs im Wechsel oder nach Uhrzeit und Datum anzeigen

Modus Externe App

Jede Android-App sperren

Mediaplayer

Digital Signage mit Video- und Bilder-Slideshow

MQTT & Home Assistant

Native MQTT-Auto-Discovery

Cloud-Verwaltung

Eine ganze Flotte registrieren und steuern

Moderne Oberfläche

Übersichtliche Einstellungen in Tabs

FreeKiosk Cloud (Fernverwaltung)

Betreiben Sie mehr als einen Kiosk? FreeKiosk Cloud ist unser optionales SaaS-Dashboard, um eine ganze Geräteflotte aus der Ferne zu überwachen, zu steuern und zu aktualisieren. Die App funktioniert auch ohne die Cloud einwandfrei, aber mit einem registrierten Gerät erhalten Sie Live-Überwachung, Fernbefehle, Gruppen, Warnmeldungen und Screenshots aus der Ferne.

Erstes Gerät dauerhaft kostenlos

Erstellen Sie ein Konto und registrieren Sie Ihr erstes Gerät kostenlos, ohne Kreditkarte. Siehe Preise.

Gerät registrieren

1

Organisation anlegen

Erstellen Sie ein Konto auf cloud.freekiosk.app und wählen Sie die Anzahl Ihrer Geräte.

2

Registrierungstoken erzeugen

Öffne im Dashboard Add Device, um ein einmaliges Registrierungstoken zu erhalten.

3

Auf dem Tablet eingeben

Öffnen Sie in den FreeKiosk-Einstellungen den Tab Erweitert, dann Cloud-Verwaltung, und fügen Sie Server-URL und Token ein.

4

Gerät erscheint in Ihrer Flotte

Es wird in Sekunden registriert und sendet alle 30 Sekunden einen Heartbeat mit seinem Status.

Was Sie in der Cloud tun können

Live-Status: Akku, Netzwerk, Speicher, Bildschirm
Fernbefehle (Neu laden, Neustart, Screenshot ...)
Gerätegruppen mit Sammelaktionen
Konfigurationsprofile (URL, Helligkeit, Lautstärke)
Warnmeldungen per E-Mail, Webhook & Push
Screenshots aus der Ferne & Aktivitätsprotokoll (CSV)
FreeKiosk Cloud entdecken

Fehlerbehebung

Der Device-Owner-Befehl schlägt fehl

Stellen Sie sicher, dass das Gerät auf Werkseinstellungen zurückgesetzt wurde und kein Google-Konto vorhanden ist. Entfernen Sie alle Konten unter Einstellungen → Konten.

ADB findet das Gerät nicht

Aktivieren Sie USB-Debugging, probieren Sie ein anderes USB-Kabel aus und installieren Sie die Gerätetreiber auf Ihrem PC.

Weißer Bildschirm im Kiosk

Prüfen Sie, ob die URL korrekt und erreichbar ist. Laden Sie die URL zuerst probeweise in Chrome.

Kioskmodus lässt sich nicht verlassen

Tippen Sie schnell 5-mal an einer beliebigen Stelle auf den Bildschirm (die Standardgeste), um die PIN-Eingabe aufzurufen.

Brauchen Sie weitere Hilfe?

Werfen Sie einen Blick in unsere FAQ oder eröffnen Sie ein Issue auf GitHub