Benachrichtigungen

Einrichtung

Eine Benachrichtigung sendet eine Nachricht per Discord oder E-Mail, wenn etwas passiert: Eine Anfrage wartet, ein Film kommt an, eine Zustandsprüfung schlägt fehl. Du brauchst die Berechtigung Change settings (Einstellungen ändern).

Eine Benachrichtigung hinzufügen

Öffne Settings > Alerts (Einstellungen > Benachrichtigungen) und klicke auf Add an Alert (Benachrichtigung hinzufügen).
Gib ihr einen Name (Name) und wähle eine Kind (Art): Discord oder E-Mail.
Fülle die Felder der Art aus (siehe Arten).
Entferne unter When to send (wann senden) die Haken bei den Momenten, die du nicht willst. Am Anfang sind alle gesetzt; All of these (alle davon) und None of these (keine davon) gelten für eine ganze Gruppe.
Lass Send messages (Nachrichten senden) an und klicke auf Save (speichern).
Klicke auf der Karte auf Send a test (Test senden). Du solltest sehen, wie die Nachricht ankommt und die Karte Last sent (zuletzt gesendet) zeigt.

Arten

Discord

Öffne in Discord die Kanaleinstellungen, dann Integrations > Webhooks (Integrationen > Webhooks), und kopiere den Link. Füge ihn in Discord link (Discord-Link) ein; er beginnt mit https://discord.com/. Wer seine Discord-Benutzer-ID im eigenen Konto eingetragen hat, wird in Nachrichten zu den eigenen Anfragen erwähnt.

E-Mail

Feld	Was du einträgst
Mail server (Mailserver), Port (Port)	Dein Mailserver
Security (Sicherheit)	STARTTLS (Port 587), TLS (Port 465) oder None. None nur für einen Mailserver in deinem eigenen Netzwerk
From address (Absenderadresse)	Die Adresse des Absenders
Mail username (Mail-Benutzername), Mail password (Mail-Passwort)	Das Mailkonto
Staff addresses (Adressen des Teams)	Eine oder mehrere, durch Kommas getrennt

Nachrichten zu einer Anfrage gehen an die Personen, die angefragt haben, an die Adresse ihres Kontos. Alles andere geht an die Adressen des Teams.

Telegram, ntfy, Gotify, Pushover und Webhooks sind in dieser Version zurückgestellt. Siehe Zurückgestellte Funktionen.

Optionen

Wann gesendet wird

Moment	Geht an	Wann
New request (neue Anfrage)	Team	Ein Film, eine Serie oder ein Künstler wartet auf Genehmigung
Approved (genehmigt)	Anfragende	Ihre Anfrage wurde genehmigt
Declined (abgelehnt)	Anfragende	Abgelehnt, mit deiner Notiz
Ready (bereit)	Anfragende	Die Dateien sind in der Bibliothek
New episodes (neue Folgen)	Anfragende und alle, die der Serie folgen	Höchstens 1 pro Serie und Stunde. Jede Person kann diese ausschalten
New albums (neue Alben)	Alle, die dem Künstler folgen	Höchstens 1 pro Künstler und Stunde
Problem reported (Problem gemeldet)	Team	Jemand hat einen Titel gemeldet. Die Meldungen stehen unter `/requests/reports`
Problem fixed (Problem behoben)	Meldende Person	Mit deiner Antwort
Sent to download (zum Download gesendet)	Team	Ein Release ging an einen Downloader
In the Library (in der Bibliothek)	Team	Dateien wurden abgelegt, auch eine bessere Kopie
Renamed (umbenannt)	Team	Dateien haben neue Namen bekommen
Added (hinzugefügt)	Team	Ein Titel wurde von Hand, aus einer Liste oder aus einer Anfrage hinzugefügt
Deleted (gelöscht)	Team	Ein Film, eine Serie, eine Staffel oder Folgen haben die Bibliothek verlassen
Health (Zustand)	Team	Eine Zustandsprüfung ist fehlgeschlagen oder wieder in Ordnung
Needs a decision (Entscheidung nötig)	Team	Ein Download oder Import braucht dich

Staffelpakete

Unter der Liste legt Season packs (Staffelpakete) fest, was ein Download mit vielen Folgen sendet: One Alert for the pack (eine Benachrichtigung für das Paket), mit einer Zeile pro Folge, oder One Alert per episode (eine Benachrichtigung pro Folge).

Das lokale Netzwerk erreichen

Standardmäßig aus. Solange es aus ist, gehen Discord-Benachrichtigungen nur an discord.com und andere Arten nur an Server im Internet; Links zu diesem Rechner oder deinem Heimnetz werden abgelehnt, auch nach einer Namensauflösung. Schalte es für einen Mailserver oder Empfänger zu Hause ein. Weiterleitungen wird nie gefolgt.

Eine Benachrichtigung pausieren

Entferne den Haken bei Send messages. Die Karte zeigt Off (aus), und die Benachrichtigung bleibt.

Passwörter und Tokens

Sie werden verschlüsselt gespeichert und dann als Stored (gespeichert) angezeigt. Lass das Feld leer, um den Wert zu behalten. Wenn du eine Benachrichtigung auf einen anderen Server richtest, gibst du das Geheimnis neu ein; ein gespeichertes Geheimnis geht nie an einen neuen Ort.

Wenn es nicht funktioniert

Symptom:

Paste the Discord link (Füge den Discord-Link ein)

Ursache: Der Link beginnt nicht mit https://discord.com/. Lösung: Kopiere den Webhook-Link noch einmal. Für einen Discord-ähnlichen Server zu Hause schalte Reach the local network (das lokale Netzwerk erreichen) ein.

Symptom:

Points to the local network, which this Alert may not reach (Zeigt auf das lokale Netzwerk, das diese Benachrichtigung nicht erreichen darf)

Ursache: Der Server steht auf diesem Rechner oder in deinem Heimnetz. Lösung: Schalte Reach the local network ein.

Symptom: Last try failed (letzter Versuch fehlgeschlagen) mit einer Antwort 401 oder 404. Ursache: Der Link oder das Token ist falsch. Solche Fehler werden nicht erneut versucht. Lösung: Korrigiere es und klicke auf Send a test.

Symptom: Die Person, die angefragt hat, hat nichts bekommen. Ursache: Keine E-Mail-Adresse oder Discord-Benutzer-ID in ihrem Konto, beim Moment fehlt der Haken, oder sie hat neue Folgen ausgeschaltet. Lösung: Prüfe diese drei Punkte.

Für Fortgeschrittene

Wiederholungen

Eine Zeitüberschreitung, eine Antwort, die zum Drosseln auffordert, oder ein Serverfehler wird nach 5 s, 30 s und 2 min erneut versucht. Verlangt der Server eine längere Wartezeit, hält HolyArrs sie ein, bis zu 5 min. Eine Ablehnung, etwa bei einem falschen Link, wird nicht erneut versucht. Jeder Fehlschlag fügt dem Verlauf eine Zeile „Alert could not be sent“ (Benachrichtigung konnte nicht gesendet werden) hinzu.

Zurückgestellte Arten und ihre Felder

Nur sichtbar, wenn der Schalter alert_channels_more an ist.

Art	Felder
Telegram	Bot token (Bot-Token) von @BotFather, Chat ID (Chat-ID; die ID eines Benutzers, einer Gruppe oder eines Kanals, oder `@channel`). Schreibe dem Bot zuerst eine Nachricht oder füge ihn zuerst der Gruppe hinzu
ntfy	Server address (Serveradresse; leer bedeutet ntfy.sh), Topic (Thema), optional Access token (Zugriffstoken). Jeder, der das Thema kennt, kann es lesen
Gotify	Server address, App token (App-Token)
Pushover	User key (Benutzerschlüssel; Gruppenschlüssel funktionieren), App token
Webhook (JSON)	Webhook link (Webhook-Link), optional Secret (Geheimnis), What the secret does (was das Geheimnis tut)

Was ein Webhook empfängt

Ein POST pro Nachricht, Content-Type: application/json, mit diesen Headern:

Header	Wert
`X-HolyArrs-Event`	Der Moment, etwa `import` oder `test`
`X-HolyArrs-Delivery`	Zufällige ID für diese Nachricht
`X-HolyArrs-Timestamp`	Mit Signs each message (signiert jede Nachricht): Sekunden seit 1970
`X-HolyArrs-Signature`	Mit Signs each message: `sha256=` plus Hex-HMAC-SHA256 von `<timestamp>.<delivery>.<body>`, mit deinem Geheimnis als Schlüssel
`Authorization`	Mit Is sent as a bearer token (wird als Bearer-Token gesendet): `Bearer <secret>`

Mit Nothing (nichts) wird kein Geheimnis gesendet. Wenn du signierst, lehne alte Zeitstempel und schon gesehene Delivery-IDs ab, damit eine kopierte Nachricht nicht erneut eingespielt werden kann.

{
  "moment": "import",
  "event_kind": "import_done",
  "subject": "In the Library: Arrival (2016)",
  "text": "Import done: 1 placed by hardlink",
  "at": "2025-01-01T18:04:11Z",
  "movie": { "id": 12, "name": "Arrival", "year": 2016, "tmdb": "329865", "imdb": "tt2543164" },
  "data": { "from": "/downloads/Arrival.2016.1080p" }
}

Weitere Felder erscheinen, wenn sie zutreffen: test, show und episodes, artist und tracks, report, people. people enthält die Namen der Anfragenden, nie Adressen. data enthält die Gründe und Pfade aus der Zeile im Verlauf, die hinter der Nachricht steht. Jede 2xx-Antwort gilt als zugestellt.