Documentation

Documentation FreeKiosk

Tout ce qu'il faut pour déployer et configurer votre kiosque

Sommaire

Présentation

FreeKiosk est une application gratuite et open source qui transforme les tablettes Android en kiosques sécurisés affichant un seul site web ou une seule web app en plein écran. Idéale pour les écrans d'information, les caisses, l'affichage dynamique et les bornes en libre accès.

Ce qu'elle fait

  • WebView plein écran ou application externe
  • API REST (plus de 40 endpoints)
  • Rotation d'URL et planificateur
  • Verrouillage complet de l'appareil

Prérequis

  • Android 8.0+ (Oreo)
  • Connexion réseau
  • ADB (pour Device Owner)

Installation

Installation simple

  1. 1

    Télécharger l'APK

    Depuis notre page de téléchargement ou Google Play Store

  2. 2

    Transférer sur l'appareil

    Par USB, par e-mail ou en téléchargement direct

  3. 3

    Installer l'application

    Si besoin, activez « Sources inconnues » dans Réglages > Sécurité

  4. 4

    Ouvrir FreeKiosk

    Configurez votre URL et vos réglages

Télécharger FreeKiosk

Mode Device Owner

Pourquoi Device Owner ?

Le mode Device Owner offre un verrouillage complet : pas de barre d'état, pas de notifications, pas de boutons de navigation, redémarrage automatique en cas de plantage, et aucun moyen pour les utilisateurs de quitter le kiosque.

Prérequis

  • Appareil réinitialisé aux paramètres d'usine (sans compte Google)
  • ADB installé sur votre ordinateur
  • Débogage USB activé sur l'appareil
  • FreeKiosk déjà installé

Installation pas à pas

Étape 1 : réinitialisation d'usine

Allez dans Réglages → Système → Options de réinitialisation → Effacer toutes les données

N'ajoutez PAS de compte Google pendant la configuration initiale. Ignorez toute création de compte.

Étape 2 : activer les options pour les développeurs
  1. Allez dans Réglages → À propos de la tablette
  2. Appuyez 7 fois sur Numéro de build
  3. Revenez dans Réglages → Options pour les développeurs
  4. Activez le débogage USB
Étape 3 : installer FreeKiosk

Installez l'APK par transfert USB, téléchargement web ou carte SD. Assurez-vous que l'application est installée avant de lancer la commande ADB.

Étape 4 : définir Device Owner

Connectez la tablette en USB et exécutez :

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

Vous devriez voir : Success: Device owner set

Retirer le mode Device Owner

Pour retirer le statut Device Owner, allez dans Réglages FreeKiosk → Retirer Device Owner, ou exécutez :

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

Configuration de base (prise en main rapide)

1Votre URL

L'URL que la tablette affichera en permanence.

https://freekiosk.app

2Code PIN

Code PIN de 4 à 6 chiffres pour accéder aux réglages.

3Mode recommandé

UsageModeÉpinglage d'écran
🌐 Page webWebView✅ Activé
📺 Application externeApplication externe✅ Activé
🧪 Test / démoWebView❌ Désactivé

4Réglages essentiels

OptionValeur recommandée
Plein écran✅ Activé
Démarrage automatique au lancement de l'appareil✅ Activé
Masquer la barre d'état✅ Activé
Délai de mise en veille de l'écranJamais (ou via l'économiseur d'écran)
Luminosité50-70 %

5API REST (facultative)

Pilotez votre tablette depuis Home Assistant.

Consultez la documentation de l'API pour plus de détails.

Fonctionnalités

Verrouillage complet

Aucune sortie sans code PIN

API REST

Plus de 40 endpoints pour Home Assistant

Rotation d'URL et planificateur

Alternez ou planifiez les URL selon l'heure et la date

Mode application externe

Verrouillez n'importe quelle application Android

Lecteur multimédia

Affichage dynamique : diaporama de vidéos et d'images

MQTT et Home Assistant

Découverte automatique MQTT native

Gestion depuis le Cloud

Enrôlez et pilotez toute une flotte

Interface moderne

Réglages organisés par onglets

FreeKiosk Cloud (gestion à distance)

Plus d'un kiosque à gérer ? FreeKiosk Cloud est notre tableau de bord SaaS facultatif pour surveiller, piloter et mettre à jour à distance toute une flotte d'appareils. L'application fonctionne très bien sans lui, mais enrôler un appareil donne accès à la supervision en direct, aux commandes à distance, aux groupes, aux alertes et aux captures d'écran à distance.

Premier appareil gratuit, pour toujours

Créez un compte et enrôlez votre premier appareil gratuitement, sans carte bancaire. Voir les tarifs.

Enrôler un appareil

1

Créez votre organisation

Créez un compte sur cloud.freekiosk.app et choisissez votre nombre d'appareils.

2

Générez un jeton d'enrôlement

Dans le tableau de bord, ouvrez Ajouter un appareil pour obtenir un jeton d'enrôlement à usage unique.

3

Saisissez-le sur la tablette

Dans les réglages FreeKiosk, ouvrez l'onglet Avancé, puis Gestion du Cloud, et collez l'URL du serveur et le jeton.

4

L'appareil apparaît dans votre flotte

Il s'enrôle en quelques secondes et envoie un heartbeat avec son état toutes les 30 secondes.

Ce que vous pouvez faire depuis le Cloud

État en direct : batterie, réseau, stockage, écran
Commandes à distance (rechargement, redémarrage, capture d'écran...)
Groupes d'appareils avec actions groupées
Profils de configuration (URL, luminosité, volume)
Alertes par e-mail, webhook et notification push
Captures d'écran à distance et journal d'activité (CSV)
Découvrir FreeKiosk Cloud

Dépannage

La commande Device Owner échoue

Vérifiez que l'appareil a bien été réinitialisé aux paramètres d'usine, sans compte Google. Supprimez tous les comptes dans Réglages → Comptes.

Appareil ADB introuvable

Activez le débogage USB, essayez un autre câble USB et installez les pilotes de l'appareil sur votre PC.

Écran blanc dans le kiosque

Vérifiez que l'URL est correcte et accessible. Essayez d'abord de la charger dans Chrome.

Impossible de quitter le mode kiosque

Touchez rapidement 5 fois l'écran n'importe où (le geste par défaut) pour faire apparaître l'écran du PIN.

Besoin d'aide ?

Consultez notre FAQ ou ouvrez une issue sur GitHub

Voir la FAQIssues GitHub