Skip to content

Supernotify

Supernotify

Rhizomatics Open Source hacs

Ruff pre-commit.ci status Coverage Tests Github Deploy CodeQL Dependabot Updates

Adicionar ao HACS


Notificações Unificadas para Home Assistant

ALTERAÇÃO IMPORTANTE v2.0.0

A versão 2.0.0 do SuperNotify passa a usar uma configuração nativa da interface do Home Assistant ('ConfigFlow'). Se já tiver uma configuração simples, tudo será migrado automaticamente por si e não será necessário YAML.

Se tiver uma configuração avançada (entregas, cenários, câmeras, pessoas, ações etc.), será gerada uma reparação para mover essas definições para um novo ficheiro supernotify.yaml e adicionar uma instrução include ao seu configuration.yaml. Ou pode optar por mover a configuração manualmente para fora do bloco notify, da forma que preferir.

Em qualquer dos casos, nada será eliminado ou comentado, pelo que será fácil reverter a alteração. Remova a configuração antiga quando tiver a certeza de que a nova versão está a funcionar bem para si.

Uma interface de notificação unificada sobre a plataforma notify integrada do Home Assistant, para simplificar consideravelmente múltiplos canais de notificação e cenários complexos, incluindo notificações multicanal, notificações condicionais, ações móveis, capturas de câmera, carrilhões e e-mails HTML baseados em modelos.

Supernotify tem um único objetivo — fazer com que a notificação mais simples possível envie tantas notificações quanto necessário, sem código e com configuração mínima.

Isso mantém as automações, scripts e aplicativos AppDaemon simples e fáceis de manter, com todos os detalhes e regras gerenciados em um único lugar. A menor notificação possível — apenas uma mensagem — pode ser suficiente para acionar tudo. Altere endereços de e-mail em um único lugar e deixe o Supernotify determinar quais aplicativos móveis usar.

Apenas com a configuração da interface, comece as notificações push móveis para todos os registrados em casa, sem configurar os nomes dos aplicativos móveis nas notificações.

Distribuição

Supernotify é um componente personalizado disponível através do Home Assistant Community Shop (HACS). É gratuito e de código aberto sob a licença Apache 2.0.

Documentação

Experimente o Início Rápido, a explicação dos conceitos fundamentais e os adaptadores de transporte disponíveis. Notificando mostra como chamar o Supernotify a partir de automações ou da página de ferramentas do desenvolvedor.

Há muitas receitas com exemplos de configuração, ou navegue por tags.

Funcionalidades

  • Uma ação -> Múltiplas notificações
    • Remova configurações e código repetitivos das automações
    • Os adaptadores ajustam automaticamente os dados de notificação para cada integração
    • Por exemplo, use com um Blueprint do Frigate para receber capturas de câmera por e-mail
  • Configuração automática
    • Configuração de entrega para notificações push móveis, e-mail (SMTP) e entidades de notificação configurada automaticamente
    • Aplicativos móveis descobertos automaticamente, incluindo fabricante e modelo do telefone
    • Dispositivos Alexa para carrilhões descobertos automaticamente
  • Além das integrações notify
    • Carrilhões, sirenes, SMS, TTS, anúncios e sons Alexa, chamadas de API, dispositivos MQTT, Gotify, ntfy
    • Todas as implementações padrão notify e notify.group disponíveis
    • Uso muito simplificado de notificações push móveis, por ex. para iPhone
  • Notificações condicionais
    • Usando conditions padrão do Home Assistant
    • Variáveis de condição adicionais, incluindo mensagem e prioridade
    • Combine com detecção de ocupação para personalizar notificações
  • Cenários para configuração simples e concisa
    • Agrupe blocos comuns de configuração e lógica condicional
    • Aplique sob demanda (red_alert, nerdy) ou automaticamente com base em condições
  • Modelo unificado de pessoa
    • Defina um e-mail, número de SMS ou dispositivo móvel e use a entidade person em ações de notificação
    • Pessoas são configuradas automaticamente junto com seus aplicativos móveis
  • Modelos de e-mail HTML fáceis
    • Jinja2 padrão do Home Assistant, definido na configuração YAML, em chamadas de ação ou como arquivos independentes
    • Modelo geral padrão incluído
  • Ações móveis
    • Configure um conjunto consistente de ações móveis para múltiplas notificações
    • Inclua ações de soneca para silenciar com base em critérios
  • Capturas de imagem flexíveis
    • Suporta câmeras, imagens MQTT e URLs de imagens
    • Reposicione câmeras para predefinições PTZ antes e depois de uma captura
  • Escolha do nível de configuração
    • Defina padrões no nível do adaptador de transporte, entrega e ação
  • Supressão de notificações duplicadas
    • Configure o tempo de espera antes de reautorizar
  • Arquivamento de notificações e suporte a depuração
    • Arquive opcionalmente notificações no sistema de arquivos e/ou tópico MQTT
    • Inclui informações completas de depuração
    • Entregas, transportes, destinatários e cenários expostos como entidades na interface do Home Assistant

YAML apenas para uso avançado

Atualmente, o Supernotify suporta a configuração padrão pela interface do Home Assistant para a configuração básica, e configuração YAML para recursos avançados. O YAML será mantido para facilitar o trabalho com bases de regras maiores.

Muito pode ser feito com a simples configuração sem YAML, incluindo a automação da configuração de push móvel. Veja as receitas na documentação, e este exemplo de push móvel:

Com zero YAML, tudo configurado pela interface
  - action: notify.supernotify
    data:
        message: Olá! Testando o Supernotify enviando para os aplicativos móveis de todos

Rhizomatics Open Source para Home Assistant

HACS

  • AutoArm - Armar e desarmar automaticamente painéis de controle de alarme do Home Assistant usando botões físicos, presença, calendários e mais
  • Remote Logger - Captura de eventos OpenTelemetry (OTLP) e Syslog para Home Assistant

Python / Docker

  • Anpr2MQTT - Integração com câmeras ANPR/ALPR de placas via sistema de arquivos para MQTT
  • Updates2MQTT - Notificação automática via MQTT em atualizações de imagens Docker