Documentazione

Documentazione di FreeKiosk

Tutto ciò che ti serve per installare e configurare il tuo kiosk

Panoramica

FreeKiosk è un'applicazione gratuita e open source che trasforma i tablet Android in kiosk sicuri, con un solo sito web o una sola web app a schermo intero. Ideale per display informativi, sistemi POS, digital signage e terminali ad accesso pubblico.

Cosa fa

  • WebView o app esterna a schermo intero
  • API REST (oltre 40 endpoint)
  • Rotazione degli URL e pianificazione
  • Blocco completo del dispositivo

Requisiti

  • Android 8.0+ (Oreo)
  • Connessione di rete
  • ADB (per Device Owner)

Installazione

Installazione di base

  1. 1

    Scarica l'APK

    Dalla nostra pagina di download o da Google Play Store

  2. 2

    Trasferiscilo sul dispositivo

    Via USB, e-mail o download diretto

  3. 3

    Installa l'app

    Se serve, attiva "Origini sconosciute" in Impostazioni > Sicurezza

  4. 4

    Apri FreeKiosk

    Configura l'URL e le impostazioni

Scarica FreeKiosk

Modalità Device Owner

Perché Device Owner?

La modalità Device Owner offre un blocco completo: niente barra di stato, niente notifiche, niente pulsanti di navigazione, riavvio automatico in caso di crash e nessun modo per gli utenti di uscire dal kiosk.

Requisiti

  • Dispositivo ripristinato ai dati di fabbrica (senza account Google)
  • ADB installato sul tuo computer
  • Debug USB attivato sul dispositivo
  • FreeKiosk già installato

Configurazione passo dopo passo

Passo 1: ripristino dei dati di fabbrica

Vai su Impostazioni → Sistema → Opzioni di ripristino → Cancella tutti i dati

NON aggiungere un account Google durante la configurazione iniziale. Salta la creazione di qualsiasi account.

Passo 2: attiva le Opzioni sviluppatore
  1. Vai su Impostazioni → Informazioni sul tablet
  2. Tocca 7 volte Numero build
  3. Torna in Impostazioni → Opzioni sviluppatore
  4. Attiva Debug USB
Passo 3: installa FreeKiosk

Installa l'APK tramite trasferimento USB, download dal web o scheda SD. Assicurati che l'app sia installata prima di eseguire il comando ADB.

Passo 4: imposta Device Owner

Collega il tablet via USB ed esegui:

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

Dovresti vedere: Success: Device owner set

Rimuovere la modalità Device Owner

Per rimuovere lo stato di Device Owner, vai su Impostazioni di FreeKiosk → Rimuovi Device Owner, oppure esegui:

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

Configurazione di base (avvio rapido)

1Il tuo URL

L'URL che il tablet mostrerà in modo permanente.

https://freekiosk.app

2Codice PIN

PIN di 4-6 cifre per accedere alle impostazioni.

3Modalità consigliata

UtilizzoModalitàBlocco su schermo
🌐 Pagina webWebView✅ Attivato
📺 App esternaApp esterna✅ Attivato
🧪 Test / DemoWebView❌ Disattivato

4Impostazioni essenziali

OpzioneValore consigliato
Schermo intero✅ Attivato
Avvio automatico all'accensione✅ Attivato
Nascondi barra di stato✅ Attivato
Timeout dello schermoMai (o tramite salvaschermo)
Luminosità50-70%

5API REST (facoltativa)

Controlla il tuo tablet da Home Assistant.

Per maggiori dettagli, consulta la documentazione dell'API.

Funzionalità

Blocco completo

Nessuna uscita senza codice PIN

API REST

Oltre 40 endpoint per Home Assistant

Rotazione degli URL e pianificazione

Alterna o pianifica gli URL per ora e data

Modalità app esterna

Blocca qualsiasi app Android

Media player

Digital signage con slideshow di video e immagini

MQTT e Home Assistant

Auto-discovery MQTT nativa

Gestione dal Cloud

Registra e controlla un'intera flotta

Interfaccia moderna

Impostazioni organizzate in schede

FreeKiosk Cloud (gestione da remoto)

Gestisci più di un kiosk? FreeKiosk Cloud è la nostra dashboard SaaS facoltativa per monitorare, controllare e aggiornare da remoto un'intera flotta di dispositivi. L'app funziona perfettamente anche senza, ma registrare un dispositivo sblocca monitoraggio in tempo reale, comandi da remoto, gruppi, avvisi e screenshot da remoto.

Il primo dispositivo è gratuito, per sempre

Crea un account e registra gratuitamente il tuo primo dispositivo, senza carta di credito. Vedi i prezzi.

Registrare un dispositivo

1

Crea la tua organizzazione

Crea un account su cloud.freekiosk.app e scegli il numero di dispositivi.

2

Genera un token di registrazione

Nella dashboard, apri Aggiungi dispositivo per ottenere un token di registrazione monouso.

3

Inseriscilo sul tablet

Nelle impostazioni di FreeKiosk, apri la scheda Avanzate, poi Gestione cloud, e incolla l'URL del server e il token.

4

Il dispositivo compare nella tua flotta

Si registra in pochi secondi e invia un heartbeat con il suo stato ogni 30 secondi.

Cosa puoi fare dal Cloud

Stato in tempo reale: batteria, rete, memoria, schermo
Comandi da remoto (ricarica, riavvio, screenshot...)
Gruppi di dispositivi con azioni in blocco
Profili di configurazione (URL, luminosità, volume)
Avvisi via e-mail, webhook e notifiche push
Screenshot da remoto e registro attività (CSV)
Scopri FreeKiosk Cloud

Risoluzione dei problemi

Il comando Device Owner non funziona

Assicurati che il dispositivo sia stato ripristinato ai dati di fabbrica e che non abbia alcun account Google. Rimuovi tutti gli account in Impostazioni → Account.

Dispositivo ADB non trovato

Attiva il debug USB, prova un altro cavo USB e installa i driver del dispositivo sul PC.

Schermo bianco nel kiosk

Controlla che l'URL sia corretto e raggiungibile. Prova prima a caricarlo in Chrome.

Impossibile uscire dalla modalità kiosk

Tocca rapidamente 5 volte lo schermo in qualsiasi punto (il gesto predefinito) per far comparire la schermata del PIN.

Ti serve altro aiuto?

Consulta le nostre FAQ o apri una issue su GitHub