Meldingen
Installatie
Een melding (Alert) stuurt een Discord- of e-mailbericht als er iets gebeurt: een aanvraag wacht, een film is binnen, een gezondheidscontrole faalt. Je hebt het recht Change settings (instellingen wijzigen) nodig.
Een melding toevoegen
Link naar Een melding toevoegen- Open Settings > Alerts (Instellingen > Meldingen) en klik op Add an Alert (melding toevoegen).
- Geef de melding een Name (naam) en kies een Kind (soort): Discord of e-mail.
- Vul de velden van dat soort in (zie Soorten).
- Haal onder When to send (wanneer versturen) de momenten weg die je niet wilt. Ze staan allemaal aangevinkt; All of these (al deze) en None of these (geen van deze) werken op een hele groep.
- Laat Send messages (berichten versturen) aan staan en klik op Save.
- Klik op de kaart op Send a test (testbericht versturen). Je ziet het bericht binnenkomen en de kaart toont Last sent (laatst verstuurd).
Soorten
Link naar SoortenDiscord
Link naar DiscordOpen in Discord de kanaalinstellingen, daarna Integrations > Webhooks, en kopieer de link. Plak hem in Discord link; hij begint met https://discord.com/. Mensen die hun Discord-gebruikers-ID aan hun account hebben toegevoegd, worden genoemd in berichten over hun aanvragen.
| Veld | Wat je invult |
|---|---|
| Mail server, Port | Je mailserver |
| Security | STARTTLS (poort 587), TLS (poort 465) of None. None alleen voor een mailserver op je eigen netwerk |
| From address | Het afzenderadres |
| Mail username, Mail password | Het mailaccount |
| Staff addresses | Een of meer, gescheiden door komma’s |
Berichten over een aanvraag gaan naar de mensen die de aanvraag hebben gedaan, op het adres van hun account. Al het andere gaat naar de beheeradressen (Staff addresses).
Telegram, ntfy, Gotify, Pushover en webhooks zijn in deze versie uitgesteld. Zie Uitgestelde functies.
Keuzes
Link naar KeuzesWanneer versturen
Link naar Wanneer versturen| Moment | Gaat naar | Wanneer |
|---|---|---|
| New request | Beheerders | Een film, serie of artiest wacht op goedkeuring |
| Approved | Aanvragers | Hun aanvraag is goedgekeurd |
| Declined | Aanvragers | Geweigerd, met jouw opmerking |
| Ready | Aanvragers | De bestanden staan in de bibliotheek |
| New episodes | Aanvragers en volgers | Hooguit 1 per serie per uur. Iedereen kan ze uitzetten |
| New albums | Volgers van de artiest | Hooguit 1 per artiest per uur |
| Problem reported | Beheerders | Iemand heeft een titel gemeld. Meldingen staan op /requests/reports |
| Problem fixed | Melder | Met jouw antwoord |
| Sent to download | Beheerders | Een release is naar een downloader gegaan |
| In the Library | Beheerders | Bestanden zijn geplaatst, ook een betere kopie |
| Renamed | Beheerders | Bestanden hebben nieuwe namen gekregen |
| Added | Beheerders | Een titel is met de hand, vanuit een lijst of vanuit een aanvraag toegevoegd |
| Deleted | Beheerders | Een film, serie, seizoen of aflevering is uit de bibliotheek gegaan |
| Health | Beheerders | Een gezondheidscontrole faalt of is hersteld |
| Needs a decision | Beheerders | Een download of import heeft jou nodig |
Seizoenspakketten
Link naar SeizoenspakkettenOnder de lijst bepaalt Season packs wat één download met veel afleveringen verstuurt: One Alert for the pack (één melding voor het pakket), met een regel per aflevering, of One Alert per episode (één melding per aflevering).
Het lokale netwerk bereiken
Link naar Het lokale netwerk bereikenStandaard uit. Zolang dit uit staat, gaan Discord-meldingen alleen naar discord.com en andere soorten alleen naar servers op internet; links naar deze computer of je thuisnetwerk worden geweigerd, ook na het opzoeken van de naam. Zet het aan voor een mailserver of ontvanger bij je thuis. Doorverwijzingen worden nooit gevolgd.
Een melding pauzeren
Link naar Een melding pauzerenHaal het vinkje bij Send messages weg. De kaart toont Off en de melding blijft bestaan.
Wachtwoorden en tokens
Link naar Wachtwoorden en tokensOpgeslagen versleuteld en daarna getoond als Stored. Laat het veld leeg om de opgeslagen waarde te houden. Richt je een melding op een andere server, dan typ je het geheim opnieuw; een opgeslagen geheim gaat nooit naar een nieuwe plek.
Als het niet werkt
Link naar Als het niet werktSymptoom:
Paste the Discord link
Oorzaak: de link begint niet met https://discord.com/.
Oplossing: kopieer de webhooklink opnieuw. Zet voor een Discord-achtige server bij je thuis Reach the local network (lokale netwerk bereiken) aan.
Symptoom:
Points to the local network, which this Alert may not reach
Oorzaak: de server staat op deze computer of op je thuisnetwerk. Oplossing: zet Reach the local network aan.
Symptoom: Last try failed met als antwoord 401 of 404. Oorzaak: de link of token klopt niet. Deze worden niet opnieuw geprobeerd. Oplossing: corrigeer dit en klik op Send a test.
Symptoom: degene die de aanvraag deed, kreeg niets. Oorzaak: geen e-mailadres of Discord-gebruikers-ID bij hun account, het moment is uitgevinkt, of ze hebben nieuwe afleveringen uitgezet. Oplossing: controleer die drie punten.
Voor gevorderden
Link naar Voor gevorderdenNieuwe pogingen
Bij een time-out, een antwoord dat zegt dat het trager moet of een serverfout wordt na 5 s, 30 s en 2 min opnieuw geprobeerd. Een langere wachttijd die de server vraagt, wordt aangehouden, tot 5 min. Een weigering, zoals een foute link, wordt niet opnieuw geprobeerd. Elke mislukking voegt een rij “Alert could not be sent” toe aan de geschiedenis.
Uitgestelde soorten en hun velden
Alleen zichtbaar met de schakelaar alert_channels_more aan.
| Soort | Velden |
|---|---|
| Telegram | Bot token van @BotFather, Chat ID (ID van gebruiker, groep of kanaal, of @channel). Stuur eerst de bot een bericht of voeg hem toe aan de groep |
| ntfy | Server address (leeg betekent ntfy.sh), Topic, optioneel Access token. Iedereen die het topic kent, kan het lezen |
| Gotify | Server address, App token |
| Pushover | User key (groepssleutels werken), App token |
| Webhook (JSON) | Webhook link, optioneel Secret, What the secret does |
Wat een webhook ontvangt
Eén POST per bericht, Content-Type: application/json, met deze headers:
| Header | Waarde |
|---|---|
X-HolyArrs-Event |
Het moment, zoals import of test |
X-HolyArrs-Delivery |
Willekeurig ID voor dit bericht |
X-HolyArrs-Timestamp |
Met Signs each message: seconden sinds 1970 |
X-HolyArrs-Signature |
Met Signs each message: sha256= plus hex-HMAC-SHA256 van <timestamp>.<delivery>.<body>, met jouw geheim als sleutel |
Authorization |
Met Is sent as a bearer token: Bearer <secret> |
Met Nothing wordt geen geheim meegestuurd. Weiger bij ondertekening oude timestamps en delivery-ID’s die je al gezien hebt, zodat een gekopieerd bericht niet opnieuw kan worden afgespeeld.
{ "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" }}Andere velden verschijnen als ze van toepassing zijn: test, show en episodes, artist en tracks, report, people. people bevat namen van aanvragers, nooit adressen. data bevat de redenen en paden uit de geschiedenisrij achter het bericht. Elk 2xx-antwoord telt als afgeleverd.
Gerelateerde pagina’s
Link naar Gerelateerde pagina’sHolyArrs is gratis. Heeft het je tijd bespaard, geef het een ster op GitHub, sponsor het of trakteer me op een kop koffie.