Documentação

Documentação do FreeKiosk

Tudo o que você precisa para implantar e configurar seu quiosque

Visão geral

O FreeKiosk é um aplicativo gratuito e de código aberto que transforma tablets Android em quiosques seguros, exibindo um único site ou web app em tela cheia. Ideal para painéis de informação, sistemas de PDV, sinalização digital e terminais de acesso público.

O que ele faz

  • WebView em tela cheia ou app externo
  • API REST (mais de 40 endpoints)
  • Rotação de URLs e agendador
  • Bloqueio completo do dispositivo

Requisitos

  • Android 8.0+ (Oreo)
  • Conexão de rede
  • ADB (para o Device Owner)

Instalação

Instalação básica

  1. 1

    Baixe o APK

    Na nossa página de download ou na Google Play Store

  2. 2

    Transfira para o dispositivo

    Por USB, e-mail ou download direto

  3. 3

    Instale o app

    Se necessário, ative "Instalar apps desconhecidos" em Configurações > Segurança

  4. 4

    Abra o FreeKiosk

    Defina sua URL e suas configurações

Baixar o FreeKiosk

Modo Device Owner

Por que usar o Device Owner?

O modo Device Owner oferece bloqueio completo: sem barra de status, sem notificações, sem botões de navegação, com reinício automático em caso de falha e sem nenhuma forma de o usuário sair do quiosque.

Requisitos

  • Dispositivo com restauração de fábrica (sem conta Google)
  • ADB instalado no seu computador
  • Depuração USB ativada no dispositivo
  • FreeKiosk já instalado

Configuração passo a passo

Passo 1: restauração de fábrica

Acesse Configurações → Sistema → Opções de redefinição → Apagar todos os dados

NÃO adicione uma conta Google durante a configuração inicial. Pule toda criação de conta.

Passo 2: ativar as Opções do desenvolvedor
  1. Acesse Configurações → Sobre o tablet
  2. Toque 7 vezes em Número da versão
  3. Volte e acesse Configurações → Opções do desenvolvedor
  4. Ative a Depuração USB
Passo 3: instalar o FreeKiosk

Instale o APK por transferência USB, download pela web ou cartão SD. Confirme que o app está instalado antes de executar o comando ADB.

Passo 4: definir o Device Owner

Conecte o tablet por USB e execute:

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

Você deve ver: Success: Device owner set

Remover o modo Device Owner

Para remover o status de Device Owner, acesse Configurações do FreeKiosk → Remover Device Owner ou execute:

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

Configuração básica (início rápido)

1Sua URL

A URL que o tablet vai exibir permanentemente.

https://freekiosk.app

2Código PIN

PIN de 4 a 6 dígitos para acessar as configurações.

3Modo recomendado

UsoModoFixação de tela
🌐 Página webWebView✅ Ativada
📺 App externoApp externo✅ Ativada
🧪 Teste / DemonstraçãoWebView❌ Desativada

4Configurações essenciais

OpçãoValor recomendado
Tela cheia✅ Ativada
Iniciar automaticamente ao ligar✅ Ativada
Ocultar a barra de status✅ Ativada
Tempo limite da telaNunca (ou pelo protetor de tela)
Brilho50-70%

5API REST (opcional)

Controle seu tablet pelo Home Assistant.

Consulte a documentação da API para mais detalhes.

Recursos

Bloqueio completo

Sem saída sem o código PIN

API REST

Mais de 40 endpoints para o Home Assistant

Rotação de URLs e agendador

Alterne ou agende URLs por hora/data

Modo App externo

Bloqueie qualquer app Android

Reprodutor de mídia

Sinalização com vídeos e apresentação de imagens

MQTT e Home Assistant

Descoberta automática MQTT nativa

Gerenciamento na Cloud

Registre e controle uma frota inteira

Interface moderna

Configurações organizadas em abas

FreeKiosk Cloud (gerenciamento remoto)

Tem mais de um quiosque? O FreeKiosk Cloud é o nosso painel SaaS opcional para monitorar, controlar e atualizar à distância uma frota inteira de dispositivos. O app funciona perfeitamente sem ele, mas registrar um dispositivo libera monitoramento em tempo real, comandos remotos, grupos, alertas e capturas de tela remotas.

Primeiro dispositivo grátis, para sempre

Crie uma conta e registre seu primeiro dispositivo gratuitamente, sem cartão de crédito. Veja os preços.

Registrar um dispositivo

1

Crie sua organização

Crie uma conta em cloud.freekiosk.app e escolha o número de dispositivos.

2

Gere um token de registro

No painel, abra Adicionar dispositivo para obter um token de registro de uso único.

3

Digite-o no tablet

Nas configurações do FreeKiosk, abra a aba Avançado, depois Gerenciamento pela nuvem, e cole a URL do servidor e o token.

4

O dispositivo aparece na sua frota

Ele é registrado em segundos e envia um heartbeat com seu status a cada 30 segundos.

O que você pode fazer pela Cloud

Status em tempo real: bateria, rede, armazenamento, tela
Comandos remotos (recarregar, reiniciar, captura de tela...)
Grupos de dispositivos com ações em massa
Perfis de configuração (URL, brilho, volume)
Alertas por e-mail, webhook e push
Capturas de tela remotas e registro de atividade (CSV)
Conhecer o FreeKiosk Cloud

Solução de problemas

O comando do Device Owner falha

Confirme que o dispositivo passou pela restauração de fábrica e está sem conta Google. Remova todas as contas em Configurações → Contas.

Dispositivo ADB não encontrado

Ative a depuração USB, tente outro cabo USB e instale os drivers do dispositivo no seu PC.

Tela branca no quiosque

Verifique se a URL está correta e acessível. Tente abrir a URL primeiro no Chrome.

Não consigo sair do modo quiosque

Toque 5 vezes rapidamente em qualquer lugar da tela (o gesto padrão) para abrir a tela do PIN.

Precisa de mais ajuda?

Consulte nossa FAQ ou abra uma issue no GitHub