ntfy Smart-Home-Integration, kostenlos und Open Source

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

• Veröffentlicht von callemand
• Messaging
• Version 1.0.0
• Erfordert Gladys >=4.62.0
• ★ 0

Auf GitHub ansehenAlle externen Integrationen

Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

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.

Konfigurationseinstellungen

Diese Einstellungen fragt ntfy in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
ntfy server URL	string	Ja	The base URL of the ntfy server, shared by everyone. Use the public https://ntfy.sh or your own self-hosted server.
Default priority	select	Nein	Priority applied to the notifications sent by Gladys.
Default notification title	string	Nein	Title shown on the notifications sent by Gladys.

So installierst du ntfy in Gladys

1. Öffne in Gladys Integrationen: ntfy erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/callemand/gladys-ntfy:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/callemand/gladys-ntfy.

ntfy benötigt Gladys >=4.62.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

ntfy ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von callemand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle externen Integrationen durchsuchen
• Die nativen Integrationen entdecken, die in Gladys eingebaut sind
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂