Documentación

Documentación de FreeKiosk

Todo lo que necesitas para desplegar y configurar tu quiosco

Índice

Visión general

FreeKiosk es una aplicación gratuita y de código abierto que convierte las tablets Android en quioscos seguros que muestran un único sitio web o web app a pantalla completa. Ideal para pantallas de información, sistemas de punto de venta, señalización digital y terminales de acceso público.

Qué hace

  • WebView a pantalla completa o app externa
  • API REST (más de 40 endpoints)
  • Rotación de URL y programador
  • Bloqueo completo del dispositivo

Requisitos

  • Android 8.0+ (Oreo)
  • Conexión de red
  • ADB (para Device Owner)

Instalación

Instalación básica

  1. 1

    Descarga el APK

    Desde nuestra página de descarga o desde Google Play Store

  2. 2

    Pásalo al dispositivo

    Por USB, por correo electrónico o con una descarga directa

  3. 3

    Instala la app

    Si hace falta, activa "Fuentes desconocidas" en Configuración > Seguridad

  4. 4

    Abre FreeKiosk

    Configura tu URL y tus ajustes

Descargar FreeKiosk

Modo Device Owner

¿Por qué Device Owner?

El modo Device Owner ofrece un bloqueo completo: sin barra de estado, sin notificaciones, sin botones de navegación, con reinicio automático si la app falla y sin ninguna forma de que los usuarios salgan del quiosco.

Requisitos

  • Dispositivo con restablecimiento de fábrica (sin cuenta de Google)
  • ADB instalado en tu ordenador
  • Depuración por USB activada en el dispositivo
  • FreeKiosk ya instalado

Configuración paso a paso

Paso 1: restablecimiento de fábrica

Ve a Configuración → Sistema → Opciones de restablecimiento → Borrar todos los datos (restablecer datos de fábrica)

NO agregues una cuenta de Google durante la configuración inicial. Omite cualquier creación de cuenta.

Paso 2: activar las opciones para desarrolladores
  1. Ve a Configuración → Acerca de la tablet
  2. Toca 7 veces Número de compilación
  3. Vuelve a Configuración → Opciones para desarrolladores
  4. Activa la depuración por USB
Paso 3: instalar FreeKiosk

Instala el APK por transferencia USB, descarga web o tarjeta SD. Asegúrate de que la app esté instalada antes de ejecutar el comando ADB.

Paso 4: definir Device Owner

Conecta la tablet por USB y ejecuta:

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

Deberías ver: Success: Device owner set

Quitar el modo Device Owner

Para quitar el estado de Device Owner, ve a Configuración de FreeKiosk → Quitar Device Owner, o ejecuta:

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

Configuración básica (primeros pasos)

1Tu URL

La URL que la tablet mostrará de forma permanente.

https://freekiosk.app

2Código PIN

PIN de 4 a 6 dígitos para acceder a la configuración.

3Modo recomendado

UsoModoFijación de pantalla
🌐 Página webWebView✅ Activada
📺 App externaApp externa✅ Activada
🧪 Prueba / demoWebView❌ Desactivada

4Ajustes esenciales

OpciónValor recomendado
Pantalla completa✅ Activada
Inicio automático al arrancar✅ Activada
Ocultar la barra de estado✅ Activada
Tiempo de espera de la pantallaNunca (o mediante el protector de pantalla)
Brillo50-70 %

5API REST (opcional)

Controla tu tablet desde Home Assistant.

Consulta la documentación de la API para más detalles.

Funciones

Bloqueo total

No se sale sin el código PIN

API REST

Más de 40 endpoints para Home Assistant

Rotación de URL y programador

Alterna o programa URL por hora y fecha

Modo app externa

Bloquea cualquier app de Android

Reproductor multimedia

Señalización con presentación de videos e imágenes

MQTT y Home Assistant

Detección automática MQTT nativa

Gestión desde el Cloud

Inscribe y controla toda una flota

Interfaz moderna

Configuración organizada en pestañas

FreeKiosk Cloud (gestión a distancia)

¿Gestionas más de un quiosco? FreeKiosk Cloud es nuestro panel SaaS opcional para supervisar, controlar y actualizar a distancia toda una flota de dispositivos. La app funciona perfectamente sin él, pero al inscribir un dispositivo se activa la supervisión en directo, los comandos a distancia, los grupos, las alertas y las capturas de pantalla a distancia.

El primer dispositivo, gratis para siempre

Crea una cuenta e inscribe tu primer dispositivo gratis, sin tarjeta. Consulta los precios.

Inscribir un dispositivo

1

Crea tu organización

Crea una cuenta en cloud.freekiosk.app y elige tu número de dispositivos.

2

Genera un token de inscripción

En el panel, abre Agregar dispositivo para obtener un token de inscripción de un solo uso.

3

Introdúcelo en la tablet

En la configuración de FreeKiosk, abre la pestaña Avanzado, luego Gestión de Cloud, y pega la URL del servidor y el token.

4

El dispositivo aparece en tu flota

Se inscribe en segundos y envía un heartbeat con su estado cada 30 segundos.

Qué puedes hacer desde el Cloud

Estado en directo: batería, red, almacenamiento, pantalla
Comandos a distancia (recargar, reiniciar, captura de pantalla...)
Grupos de dispositivos con acciones en bloque
Perfiles de configuración (URL, brillo, volumen)
Alertas por correo electrónico, webhook y notificación push
Capturas de pantalla a distancia y registro de actividad (CSV)
Descubrir FreeKiosk Cloud

Solución de problemas

El comando de Device Owner falla

Comprueba que el dispositivo tenga el restablecimiento de fábrica hecho y ninguna cuenta de Google. Elimina todas las cuentas en Configuración → Cuentas.

No se encuentra el dispositivo ADB

Activa la depuración por USB, prueba con otro cable USB e instala los controladores del dispositivo en tu PC.

Pantalla en blanco en el quiosco

Comprueba que la URL sea correcta y accesible. Prueba primero a cargarla en Chrome.

No se puede salir del modo quiosco

Toca la pantalla 5 veces rápidamente en cualquier punto (el gesto por defecto) para que aparezca la pantalla del PIN.

¿Necesitas más ayuda?

Consulta nuestras preguntas frecuentes o abre una issue en GitHub

Ver las preguntas frecuentesIssues de GitHub