Como levar o tempo de tela do Android, app por app, para o Home Assistant?

O Life Dashboard para Android, um app de código aberto, lê as estatísticas de uso do Android, os mesmos números que o Bem-estar digital (Digital Wellbeing) mostra, e envia os minutos por app para o Home Assistant seguindo uma agenda. Com a integração Life Dashboard, você tem o tempo de tela de hoje e de ontem, o app mais usado, os cinco apps mais usados, um sensor por app se quiser, e todos os dias nas estatísticas de longo prazo. Por MQTT, você recebe os mesmos totais, sem os sensores por app. Depois, automações podem avisar quando você passa de um limite que você mesmo definiu.

Por Owen Vogelaar, que mantém o Life Dashboard 6 min de leitura

Baixar o app para Android

O que você precisa

Como configurar

  1. Ao parear com o QR code, inclua Tempo de tela em Enviar de.
  2. Abra a aba Tempo de tela. Ela diz Permita o acesso aos dados de uso. Toque em Abrir as configurações do Android, encontre Life Dashboard na lista do Android, ative o acesso e volte. A aba agora mostra o seu tempo de tela, e Mais nessa aba diz Acesso aos dados de uso concedido.
  3. Abra O dia começa às. O padrão é 04:00, então o uso do celular depois da meia-noite conta para o dia anterior; para outro horário, toque em Salvar no topo dessa página. Desative Ativar virada do dia para contar de meia-noite a meia-noite.
  4. Em Apps a enviar, escolha Todos, Todos menos ou Só. A lista mostra os apps que você usou nos últimos 30 dias.
  5. Toque em Sincronizar agora.
A aba Tempo de tela do app para Android

O tempo de tela tem o seu próprio Quando enviar, separado dos dados de saúde. O Home Assistant só vê um número novo depois de uma sincronização, então, para limites, escolha A cada X minutos com 15, o mínimo que o Android permite, e toque em Salvar.

O que você recebe

Sensor da integraçãoPor MQTTO que ele guarda
sensor.<phone>_screen_time_todayScreen Time TodayO tempo de hoje, com os cinco apps mais usados e seus minutos em top_apps e, a partir da integração 1.2.0, todos os apps do dia em apps
sensor.<phone>_screen_time_yesterdayScreen Time YesterdayO total final de ontem
sensor.<phone>_most_used_app_todayScreen Time Top App TodayO app com mais minutos hoje
sensor.<phone>_<app>_screen_timeNão disponívelO tempo de um app hoje, com os minutos dele ao longo da semana em week_minutes

A integração informa o tempo em horas desde a versão 1.0.0, então 2 h 51 min aparece como 2.85 e um card Tile mostra 2h 51m. Por MQTT, e na integração antes da 1.0.0, o valor vem em minutos: 171. Os atributos ficam em minutos nos dois caminhos.

Regras dos sensores por app:

  • Eles são criados desativados. Abra o dispositivo do celular, mostre as entidades desativadas e ative os apps que interessam a você.
  • Um app ganha um sensor quando soma 5 minutos nos dias que a última sincronização trouxe. Um celular tem no máximo 50 sensores de app, contando os desativados, com os apps mais usados primeiro.
  • O sensor pertence ao pacote do app, então ele sobrevive a uma mudança de nome. Um sensor que você exclui continua excluído.
  • Um app que você não abriu hoje fica em 0, então um gatilho diário está pronto de novo no dia seguinte.

O tempo de tela total por dia também entra nas estatísticas de longo prazo, em horas, assim como o tempo por dia de cada app cujo sensor você ativou. Tempo de tela em detalhes cobre todos os atributos.

Cards para o seu dashboard

O Life Dashboard Screen Time é uma instalação separada pelo Marketplace (HACS antes do Home Assistant 2026.11) com três cards, cada um comparado a um limite diário que você define:

  • Hoje em um celular: um anel em relação ao limite, a diferença para ontem e para os últimos sete dias, e os apps com seus próprios ícones e minutos.
  • A semana: uma barra por dia, com o limite como uma linha. Toque em um dia para ver os apps dele.
  • A família: todo mundo em um só card, cada pessoa em relação ao próprio limite, com os três apps mais usados.

Com a integração 1.2.0 ou mais recente, os cards mostram todos os apps do dia; antes disso, os cinco mais usados e os sensores de app que você ativou. Eles também leem o tempo de tela de uma criança no Google Family Link ou no Microsoft Family Safety, pelas integrações da comunidade HAFamilyLink e HAFamilySafety.

Limites e alertas

Uma notificação quando o dia de hoje passa de três horas, usando a ação notify do app Companion do Home Assistant:

triggers:
  - trigger: numeric_state
    entity_id: sensor.<phone>_screen_time_today
    value_template: "{{ state.state | float(0) * (60 if state.attributes.unit_of_measurement == 'h' else 1) }}"
    above: 180
actions:
  - action: notify.mobile_app_<phone>
    data:
      message: Three hours on the phone today.

A linha value_template transforma horas em minutos e deixa os minutos como estão, então above: 180 significa três horas tanto com a integração quanto por MQTT. Troque por sensor.<phone>_youtube_screen_time e above: 60 para limitar um app, com a mesma linha value_template. A receita de limites de tempo de tela traz também uma versão para MQTT e uma verificação de uso do celular tarde da noite.

Vários celulares em um só Home Assistant

Adicione a integração uma vez por celular e dê a cada um um nome claro. Os IDs das entidades seguem o nome, então um tablet chamado “Living room tablet” gera sensor.living_room_tablet_youtube_screen_time ao lado dos sensores do seu celular. Cada celular tem seu próprio dispositivo, seu segredo e suas estatísticas.

Por MQTT, dê um nome a cada celular em Mais > Avançado > Nome do celular. Um celular com nome vira um dispositivo próprio, como Life Dashboard Companion (Pixel 8). Dois celulares sem nome publicam nos mesmos sensores.

Qualquer pessoa com acesso ao Home Assistant e aos backups dele consegue ver quais apps foram usados e quando. Em cada celular, Apps a enviar decide o que sai dele: um app filtrado não é citado em nada do que é enviado, mas o tempo dele continua contando no total do dia.

O que ele mede

  • O tempo em primeiro plano por app, em minutos inteiros. Música tocando em segundo plano não conta.
  • A interface do sistema e o launcher ficam de fora, assim como os apps usados por um minuto ou menos naquele dia.
  • Cada sincronização envia de novo os últimos 7 dias, então um dia ainda em andamento em uma sincronização é corrigido pela seguinte.
  • O app informa minutos. Ele não bloqueia apps nem define limites no próprio celular.

Life Dashboard para Android

O tempo de tela não precisa do Conexão Saúde. Qualquer celular ou tablet com Android 8.0 ou mais recente serve.

Disponível no Google Play

€ 4,99 uma única vez no Google Play: o jeito fácil, com atualizações automáticas, e ainda apoia o desenvolvimento.

Ou de graça, o mesmo app com a mesma chave de assinatura: APK no GitHub · Obtainium · F‑Droid

Baixar o app para Android Abrir a integração no Marketplace

O app de código aberto para Android que este guia usa. Sem conta e sem nuvem. Mais sobre o app.

Perguntas frequentes

Por que o total não bate exatamente com o Bem-estar digital?

O Bem-estar digital conta a partir da meia-noite, enquanto o dia do app começa às 04:00 por padrão. Além disso, apps usados por um minuto ou menos ficam de fora.

Isso funciona no iPhone?

Não. O iOS mantém os dados do Tempo de Uso dentro de uma sandbox que não consegue enviar nada para fora, então o app para iPhone não tem tempo de tela.

Dá para manter alguns apps privados?

Sim. Escolha esses apps em Todos menos, dentro de Apps a enviar. Os nomes deles não são enviados. O total do dia ainda inclui o tempo deles, então, com um só app de fora, os minutos dele podem ser deduzidos do total. Os sensores mostram os minutos dos apps que você envia, e all_apps_minutes guarda o total de todos os apps.

Posso enviar o tempo de tela para o meu próprio servidor?

Sim. A aba Tempo de tela tem a sua própria lista de webhooks, e o payload é um JSON com os minutos por app por dia. Veja o guia de webhook.