Aviseringar

En avisering skickar ett Discord- eller e-postmeddelande när något händer: en förfrågan väntar, en film hamnar i biblioteket, en hälsokontroll slår fel. Du behöver behörigheten Change settings (ändra inställningar).

Lägg till en avisering

1. Öppna Settings > Alerts (inställningar > aviseringar) och klicka på Add an Alert (lägg till en avisering).
2. Ge den ett Name (namn) och välj en Kind (typ): Discord eller e-post.
3. Fyll i typens fält (se Typer).
4. Under When to send (när den ska skickas) bockar du ur de tillfällen du inte vill ha. Alla är ibockade från början; All of these (alla dessa) och None of these (inga av dessa) fungerar på en hel grupp.
5. Låt Send messages (skicka meddelanden) vara på och klicka på Save (spara).
6. Klicka på Send a test (skicka ett test) på kortet. Du ska se meddelandet komma fram och kortet visa Last sent (senast skickat).

Typer

Discord

I Discord öppnar du kanalens inställningar, sedan Integrations > Webhooks, och kopierar länken. Klistra in den i Discord link; den börjar med https://discord.com/. Personer som har lagt till sitt Discord-användar-ID på sitt konto nämns i meddelanden om sina förfrågningar.

E-post

Fält	Vad du anger
Mail server (e-postserver), Port	Din e-postserver
Security (säkerhet)	STARTTLS (port 587), TLS (port 465) eller None. None bara för en e-postserver på ditt eget nätverk
From address (avsändaradress)	Avsändaradressen
Mail username, Mail password	E-postkontot
Staff addresses (personaladresser)	En eller flera, åtskilda med kommatecken

Meddelanden om en förfrågan går till dem som bad om titeln, på deras kontoadress. Allt annat går till personaladresserna.

Telegram, ntfy, Gotify, Pushover och webhooks hålls tillbaka i den här versionen. Se Tillbakahållna funktioner.

Val

När den ska skickas

Tillfälle	Går till	När
New request	Personal	En film, serie eller artist väntar på godkännande
Approved	De som bad om titeln	Deras förfrågan godkändes
Declined	De som bad om titeln	Avslagen, med din anteckning
Ready	De som bad om titeln	Filerna finns i biblioteket
New episodes	De som bad om titeln och följare	Högst 1 per serie och timme. Var och en kan slå av dem
New albums	Artistens följare	Högst 1 per artist och timme
Problem reported	Personal	Någon rapporterade en titel. Rapporterna finns på /requests/reports
Problem fixed	Den som rapporterade	Med ditt svar
Sent to download	Personal	En release skickades till en nedladdare
In the Library	Personal	Filer placerades, även en bättre kopia
Renamed	Personal	Filer fick nya namn
Added	Personal	En titel lades till för hand, från en lista eller från en förfrågan
Deleted	Personal	En film, serie, säsong eller några avsnitt lämnade biblioteket
Health	Personal	En hälsokontroll slog fel eller är åtgärdad
Needs a decision	Personal	En nedladdning eller import behöver dig

Säsongspaket

Under listan avgör Season packs (säsongspaket) vad en nedladdning med många avsnitt skickar: One Alert for the pack (en avisering för paketet), med en rad per avsnitt, eller One Alert per episode (en avisering per avsnitt).

Nå det lokala nätverket

Av som standard. När den är av går Discord-aviseringar bara till discord.com och andra typer bara till internetservrar; länkar till den här datorn eller ditt hemmanätverk avvisas, även efter en namnuppslagning. Slå på den för en e-postserver eller mottagare hemma. Omdirigeringar följs aldrig.

Pausa en avisering

Bocka ur Send messages. Kortet visar Off och aviseringen finns kvar.

Lösenord och token

Lagras krypterade och visas sedan som Stored (lagrad). Lämna fältet tomt för att behålla den. Pekar du en avisering mot en annan server skriver du hemligheten igen; en lagrad hemlighet går aldrig till en ny plats.

Om det inte fungerar

Symptom:

Paste the Discord link

Orsak: länken börjar inte med https://discord.com/. Lösning: kopiera webhook-länken igen. För en Discord-liknande server hemma slår du på Reach the local network (nå det lokala nätverket).

Symptom:

Points to the local network, which this Alert may not reach

Orsak: servern finns på den här datorn eller ditt hemmanätverk. Lösning: slå på Reach the local network.

Symptom: Last try failed (senaste försöket misslyckades) med svaret 401 eller 404. Orsak: länken eller token:en är fel. Dessa provas inte igen. Lösning: rätta den och klicka på Send a test.

Symptom: personen som bad om titeln fick ingenting. Orsak: ingen e-postadress eller inget Discord-användar-ID på kontot, tillfället är urbockat, eller så har personen slagit av nya avsnitt. Lösning: kontrollera de tre sakerna.

För experter

Nya försök

En timeout, ett nedbromsningssvar eller ett serverfel provas igen efter 5 s, 30 s och 2 min. En längre väntetid som servern ber om respekteras, upp till 5 min. En nekning, till exempel en felaktig länk, provas inte igen. Varje misslyckande lägger till en rad “Alert could not be sent” i History (historik).

Tillbakahållna typer och deras fält

Visas bara när reglaget alert_channels_more är på.

Typ	Fält
Telegram	Bot token från @BotFather, Chat ID (ID för användare, grupp eller kanal, eller @channel). Skriv till boten eller lägg till den i gruppen först
ntfy	Server address (tom betyder ntfy.sh), Topic, valfri Access token. Alla som känner till ämnet kan läsa det
Gotify	Server address, App token
Pushover	User key (gruppnycklar fungerar), App token
Webhook (JSON)	Webhook link, valfri Secret, What the secret does

Vad en webhook tar emot

En POST per meddelande, Content-Type: application/json, med de här headrarna:

Header	Värde
X-HolyArrs-Event	Tillfället, till exempel import eller test
X-HolyArrs-Delivery	Slumpmässigt ID för det här meddelandet
X-HolyArrs-Timestamp	Med Signs each message: sekunder sedan 1970
X-HolyArrs-Signature	Med Signs each message: sha256= plus hex-HMAC-SHA256 av <timestamp>.<delivery>.<body>, nycklad med din hemlighet
Authorization	Med Is sent as a bearer token: Bearer <secret>

Med Nothing skickas ingen hemlighet. Vid signering ska du avvisa gamla tidsstämplar och leverans-ID:n du redan har sett, så att ett kopierat meddelande inte kan spelas upp igen.

{
  "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" }
}

Andra fält visas när de är aktuella: test, show och episodes, artist och tracks, report, people. people innehåller namn på dem som bad om titlar, aldrig adresser. data innehåller orsakerna och sökvägarna från historikraden bakom meddelandet. Varje 2xx-svar räknas som levererat.

Relaterat

• Hälsokontroller
• Godkänna förfrågningar
• Användare och roller