Saltar al contenido principal

Integración domótica ntfy, gratuita y de código abierto

Integración ntfy para Gladys Assistant

Send push notifications through ntfy (ntfy.sh or self-hosted).

Ver en GitHubTodas las integraciones externas
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

Overview​

This integration lets Gladys Assistant send push notifications through ntfy, a simple notification service. When a scene sends a message to you, it is pushed to your phone through the ntfy app.

It works with the free public server https://ntfy.sh as well as with your own self-hosted ntfy server.

This is a send-only channel: Gladys only sends notifications, it does not receive messages back. Each Gladys user configures their own ntfy topic in their account, so everyone gets their notifications on their own phone.

Prerequisites​

  • The ntfy app installed on your phone (Android / iOS), or any ntfy client.
  • Internet access from your Gladys instance (to reach https://ntfy.sh), or a reachable self-hosted ntfy server.
  • A topic and an access token for it. A topic is a channel; pick a long, hard-to-guess name and protect it with a token (tk_…) allowed to publish to it.

Configuration​

The configuration has two parts:

1. Integration settings (shared, set once)​

  • ntfy server URL — https://ntfy.sh by default, or your self-hosted server;
  • Default priority — the priority of the notifications Gladys sends;
  • Default notification title — the title shown on those notifications.

2. My account (per user)​

Each Gladys user opens the integration and fills their own account block:

  • Your ntfy topic — the topic your notifications are sent to;
  • Access token — an ntfy access token (tk_…) allowed to publish to that topic.

Then subscribe to that topic in the ntfy app on your phone so the notifications reach you.

Sending notifications​

Use a Gladys scene with a "Send a message" action, choose this integration and the user to notify: the message is published to that user's ntfy topic and pushed to their phone.

Troubleshooting​

  • A user gets no notification — check that their topic and access token are filled in their account block, and that the ntfy app on their phone is subscribed to the same topic and server.
  • Publishing fails (403) — the access token is missing or not allowed to publish to the topic; create/renew it on your ntfy server.
  • Notifications arrive without a title — set the Default notification title in the integration settings.

Parámetros de configuración​

Estos son los parámetros que ntfy te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
ntfy server URLstringSíThe base URL of the ntfy server, shared by everyone. Use the public https://ntfy.sh or your own self-hosted server.
Default priorityselectNoPriority applied to the notifications sent by Gladys.
Default notification titlestringNoTitle shown on the notifications sent by Gladys.

Cómo instalar ntfy en Gladys​

  1. En Gladys, abre Integraciones: ntfy aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/callemand/gladys-ntfy:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/callemand/gladys-ntfy.

ntfy requiere Gladys >=4.62.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

ntfy es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene callemand, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en