ntfy

Schickt Nachrichten an ein Thema bei ntfy, die als Meldung auf dem Handy oder dem Desktop ankommen - bei ntfy.sh oder einem eigenen Server.

Eigenschaft	Wert
Fach	Info & Meldungen
Schlüssel	ntfy (so heißt das Plugin in Makros)
Bei frischer Installation	aus (im Marktplatz einschalten)
Befehle	1
Einrichtung	3 Felder

Wofür

Nachrichten aufs Handy oder den Desktop schicken, ohne Konto und ohne eigene App: eine Taste, die dir (oder anderen) eine Meldung sendet. Zum Beispiel „Stream läuft“, „Aufnahme gestartet“ oder ein Alarm, wenn etwas schiefgeht.

ntfy ist ein kleiner Dienst, bei dem Themen abonniert werden. Wer ein Thema in der ntfy-App (oder im Browser) abonniert hat, bekommt jede Nachricht, die dort ankommt. Das Plugin veröffentlicht mit einer einzigen Anfrage, und zwar bei ntfy.sh oder auf deinem eigenen Server.

Einrichten

Feld	Hinweis
Server (leer = ntfy.sh)	Beispiel: https://ntfy.sh
Thema (Name des Kanals)	—
Zugriffstoken (nur für geschützte Themen)	geheim: wird nach dem Speichern nie wieder angezeigt

1. Installiere auf dem Handy die ntfy-App und abonniere ein Thema mit einem Namen, den sonst niemand errät.
2. Plugins → ntfy → Aktivieren → Einrichten. Trage dasselbe Thema ein.
3. Server (leer = ntfy.sh): nur ausfüllen, wenn du einen eigenen ntfy-Server benutzt (https://ntfy.example.org). Er muss mit http oder https beginnen.
4. Zugriffstoken: nur für geschützte Themen oder einen eigenen Server mit Anmeldung. Das Token gehört dir.

Bei einem öffentlichen Server ist das Thema das Passwort. Wer den Namen kennt, liest und schreibt mit. Wähle deshalb einen langen, nicht zu erratenden Namen (stream-3f8a91c2d7b4). Das Plugin zeigt das Thema nirgends an, auch nicht in der Zustandszeile, denn sie kann auf einem Bildschirm landen, den ein Publikum sieht.

Das Thema darf nur Buchstaben, Ziffern, - und _ enthalten, höchstens 64 Zeichen, als Name und nicht als Adresse. Der Zustand heißt bereit, sobald ein Thema da ist, vorher nicht eingerichtet („Thema eintragen“).

Befehle

Befehl	Name im Makro	Felder	Passt auf
Nachricht senden	ntfy.publish	message Nachricht * title Titel (optional) priority Priorität 1-5 (optional, 3 = normal)	Taste

* ist ein Pflichtfeld.

• Nachricht ist Pflicht und darf höchstens 4096 Bytes lang sein (Umlaute zählen mehr als ein Byte). Was länger ist, würde ntfy als Anhang behandeln, und wer eine Nachricht schickt, will eine Nachricht.
• Titel (optional) erscheint als Überschrift der Meldung. Umlaute und Sonderzeichen sind erlaubt: Das Plugin gibt sie in einer Form weiter, die ntfy versteht. Zeilenumbrüche werden entfernt.
• Priorität 1-5 (optional, 3 = normal): eine ganze Zahl von 1 (leise) bis 5 (dringend). Alles andere meldet „Die Priorität muss eine ganze Zahl von 1 (leise) bis 5 (dringend) sein“.

Beispiele

ntfy.publish message=Stream läuft title=Live priority=4
ntfy.publish message=Die Aufnahme ist gestartet

Gut zu wissen

• Das Plugin folgt keiner Weiterleitung. Sonst gingen Kopfzeilen (auch das Token) mit, und aus einem POST würde ein GET, der nichts veröffentlicht, ohne dass es jemand merkt.
• Das Zeitlimit beträgt acht Sekunden („ntfy-Server nicht erreichbar (…)“, „keine Antwort innerhalb von 8 Sekunden“).
• Hinweise des Servers erscheinen in der Meldung, etwa wenn ein geschütztes Thema ein Token verlangt.
• Das Plugin ist bei einer frischen Installation aus.
• Für Nachrichten in einen Discord-Kanal gibt es das Plugin Discord, für beliebige Webadressen das Plugin Web-Anfrage.