Documentatie

FreeKiosk documentatie

Alles wat je nodig hebt om je kiosk uit te rollen en te configureren

Overzicht

FreeKiosk is een gratis open source app die Android-tablets verandert in beveiligde kiosks die één website of webapp op volledig scherm tonen. Ideaal voor informatieschermen, kassasystemen, digital signage en openbare zelfbedieningsterminals.

Wat het doet

  • WebView op volledig scherm of externe app
  • REST API (40+ endpoints)
  • URL-rotatie en planner
  • Volledige vergrendeling van het apparaat

Vereisten

  • Android 8.0+ (Oreo)
  • Netwerkverbinding
  • ADB (voor Device Owner)

Installatie

Basisinstallatie

  1. 1

    Download de APK

    Via onze downloadpagina of de Google Play Store

  2. 2

    Zet hem op het apparaat

    Via USB, e-mail of een directe download

  3. 3

    Installeer de app

    Schakel indien nodig "Onbekende bronnen" in bij Instellingen > Beveiliging

  4. 4

    Open FreeKiosk

    Stel je URL en instellingen in

FreeKiosk downloaden

Device Owner-modus

Waarom Device Owner?

De Device Owner-modus zorgt voor een volledige vergrendeling: geen statusbalk, geen meldingen, geen navigatieknoppen, automatisch herstarten na een crash en geen enkele manier voor gebruikers om de kiosk te verlaten.

Vereisten

  • Apparaat met fabrieksinstellingen hersteld (geen Google-account)
  • ADB geïnstalleerd op je computer
  • USB-foutopsporing ingeschakeld op het apparaat
  • FreeKiosk al geïnstalleerd

Stap-voor-stap instellen

Stap 1: fabrieksinstellingen herstellen

Ga naar Instellingen → Systeem → Opties voor resetten → Alle gegevens wissen

Voeg GEEN Google-account toe tijdens de eerste installatie. Sla het aanmaken van accounts helemaal over.

Stap 2: ontwikkelaarsopties inschakelen
  1. Ga naar Instellingen → Over de tablet
  2. Tik 7 keer op Buildnummer
  3. Ga terug naar Instellingen → Ontwikkelaarsopties
  4. Schakel USB-foutopsporing in
Stap 3: FreeKiosk installeren

Installeer de APK via een USB-overdracht, een download of een SD-kaart. Zorg dat de app is geïnstalleerd voordat je de ADB-opdracht uitvoert.

Stap 4: Device Owner instellen

Sluit de tablet via USB aan en voer uit:

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

Je zou dit moeten zien: Success: Device owner set

Device Owner-modus verwijderen

Om de Device Owner-status te verwijderen, ga je naar FreeKiosk-instellingen → Device Owner verwijderen, of voer je uit:

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

Basisconfiguratie (snelstart)

1Je URL

De URL die de tablet permanent toont.

https://freekiosk.app

2Pincode

Pincode van 4 tot 6 cijfers voor toegang tot de instellingen.

3Aanbevolen modus

GebruikModusScherm vastzetten
🌐 WebpaginaWebView✅ Ingeschakeld
📺 Externe appExterne app✅ Ingeschakeld
🧪 Test / demoWebView❌ Uitgeschakeld

4Essentiële instellingen

OptieAanbevolen waarde
Volledig scherm✅ Ingeschakeld
Automatisch starten bij opstarten✅ Ingeschakeld
Statusbalk verbergen✅ Ingeschakeld
Time-out van het schermNooit (of via de schermbeveiliging)
Helderheid50-70%

5REST API (optioneel)

Bedien je tablet vanuit Home Assistant.

Zie de API-documentatie voor meer details.

Functies

Volledige vergrendeling

Geen uitweg zonder pincode

REST API

40+ endpoints voor Home Assistant

URL-rotatie en planner

Wissel URL's af of plan ze op tijd en datum

Modus Externe app

Vergrendel elke Android-app

Mediaspeler

Digital signage met een diavoorstelling van video's en afbeeldingen

MQTT en Home Assistant

Native MQTT auto-discovery

Beheer via Cloud

Registreer en bedien een heel apparatenpark

Moderne interface

Overzichtelijke instellingen met tabbladen

FreeKiosk Cloud (beheer op afstand)

Meer dan één kiosk te beheren? FreeKiosk Cloud is ons optionele SaaS-dashboard om een heel apparatenpark op afstand te bewaken, te bedienen en bij te werken. De app werkt prima zonder, maar zodra je een apparaat registreert, krijg je live monitoring, opdrachten op afstand, groepen, meldingen en schermafbeeldingen op afstand.

Eerste apparaat gratis, voor altijd

Maak een account aan en registreer je eerste apparaat gratis, zonder creditcard. Zie de prijzen.

Een apparaat registreren

1

Maak je organisatie aan

Maak een account aan op cloud.freekiosk.app en kies het aantal apparaten.

2

Genereer een registratietoken

Open in het dashboard Apparaat toevoegen om een registratietoken voor eenmalig gebruik te krijgen.

3

Voer het in op de tablet

Open in de FreeKiosk-instellingen het tabblad Geavanceerd, dan Cloudbeheer, en plak de server-URL en het token.

4

Het apparaat verschijnt in je apparatenpark

Het wordt binnen enkele seconden geregistreerd en stuurt elke 30 seconden een heartbeat met zijn status.

Wat je vanuit de Cloud kunt doen

Live status: batterij, netwerk, opslag, scherm
Opdrachten op afstand (herladen, herstarten, schermafbeelding...)
Apparaatgroepen met bulkacties
Configuratieprofielen (URL, helderheid, volume)
Meldingen via e-mail, webhook en push
Schermafbeeldingen op afstand en activiteitenlog (CSV)
FreeKiosk Cloud ontdekken

Probleemoplossing

De Device Owner-opdracht mislukt

Controleer of de fabrieksinstellingen van het apparaat zijn hersteld en er geen Google-account op staat. Verwijder alle accounts via Instellingen → Accounts.

ADB-apparaat niet gevonden

Schakel USB-foutopsporing in, probeer een andere USB-kabel en installeer de apparaatstuurprogramma's op je pc.

Wit scherm in de kiosk

Controleer of de URL klopt en bereikbaar is. Probeer de URL eerst in Chrome te laden.

Kioskmodus kan niet worden verlaten

Tik snel 5 keer ergens op het scherm (het standaardgebaar) om het pincodescherm te openen.

Meer hulp nodig?

Bekijk onze FAQ of open een issue op GitHub