Ga naar inhoud

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
  1. Open Settings > Alerts (Instellingen > Meldingen) en klik op Add an Alert (melding toevoegen).
  2. Geef de melding een Name (naam) en kies een Kind (soort): Discord of e-mail.
  3. Vul de velden van dat soort in (zie Soorten).
  4. 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.
  5. Laat Send messages (berichten versturen) aan staan en klik op Save.
  6. Klik op de kaart op Send a test (testbericht versturen). Je ziet het bericht binnenkomen en de kaart toont Last sent (laatst verstuurd).

Open 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.

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

Onder 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 bereiken

Standaard 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 pauzeren

Haal het vinkje bij Send messages weg. De kaart toont Off en de melding blijft bestaan.

Wachtwoorden en tokens

Link naar Wachtwoorden en tokens

Opgeslagen 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.

Symptoom:

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.

Nieuwe 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’s

HolyArrs is gratis. Heeft het je tijd bespaard, geef het een ster op GitHub, sponsor het of trakteer me op een kop koffie.