Avvisi

Un avviso invia un messaggio Discord o email quando succede qualcosa: una richiesta è in attesa, arriva un film, un controllo di salute fallisce. Ti serve il permesso Change settings (modificare le impostazioni).

Aggiungere un avviso

1. Apri Settings > Alerts (impostazioni > avvisi) e premi Add an Alert (aggiungi un avviso).
2. Dagli un Name (nome) e scegli un Kind (tipo): Discord o email.
3. Compila i campi del tipo (vedi Tipi).
4. Sotto When to send (quando inviare), togli la spunta ai momenti che non vuoi. Partono tutti spuntati; All of these (tutti questi) e None of these (nessuno di questi) agiscono su un intero gruppo.
5. Lascia attivo Send messages (invia messaggi) e premi Save (salva).
6. Premi Send a test (invia una prova) sulla scheda. Dovresti vedere arrivare il messaggio e la scheda mostrare Last sent (ultimo invio).

Tipi

Discord

In Discord, apri le impostazioni del canale, poi Integrations > Webhooks, e copia il link. Incollalo in Discord link; inizia con https://discord.com/. Chi ha aggiunto il proprio ID utente Discord al suo account viene menzionato nei messaggi sulle sue richieste.

Email

Campo	Cosa scrivere
Mail server, Port	Il tuo server di posta
Security	STARTTLS (porta 587), TLS (porta 465) o None. None solo per un server di posta sulla tua rete
From address	L’indirizzo del mittente
Mail username, Mail password	L’account di posta
Staff addresses	Uno o più, separati da virgole

I messaggi su una richiesta vanno a chi l’ha fatta, all’indirizzo del suo account. Tutto il resto va agli indirizzi dello staff.

Telegram, ntfy, Gotify, Pushover e i webhook sono in sospeso in questa versione. Vedi Funzioni in sospeso.

Scelte

Quando inviare

Momento	Va a	Quando
New request	Staff	Un film, una serie o un artista è in attesa di approvazione
Approved	Chi ha richiesto	La loro richiesta è stata approvata
Declined	Chi ha richiesto	Rifiutata, con la tua nota
Ready	Chi ha richiesto	I file sono nella Libreria
New episodes	Chi ha richiesto e chi segue	Al massimo 1 per serie all’ora. Ogni persona può disattivarli
New albums	Chi segue l’artista	Al massimo 1 per artista all’ora
Problem reported	Staff	Qualcuno ha segnalato un titolo. Le segnalazioni sono in /requests/reports
Problem fixed	Chi ha segnalato	Con la tua risposta
Sent to download	Staff	Una release è andata a un downloader
In the Library	Staff	I file sono stati sistemati, anche una copia migliore
Renamed	Staff	I file hanno ricevuto nuovi nomi
Added	Staff	Un titolo è stato aggiunto a mano, da una lista o da una richiesta
Deleted	Staff	Un film, una serie, una stagione o degli episodi hanno lasciato la Libreria
Health	Staff	Un controllo di salute è fallito o è stato risolto
Needs a decision	Staff	Un download o un’importazione ha bisogno di te

Pacchetti di stagione

Sotto l’elenco, Season packs (pacchetti di stagione) decide cosa invia un download con molti episodi: One Alert for the pack (un avviso per il pacchetto), con una riga per episodio, oppure One Alert per episode (un avviso per episodio).

Raggiungere la rete locale

Disattivato per impostazione predefinita. Finché è disattivato, gli avvisi Discord vanno solo a discord.com e gli altri tipi solo a server su internet; i link a questo computer o alla tua rete di casa vengono rifiutati, anche dopo una ricerca del nome. Attivalo per un server di posta o un server ricevente a casa. I reindirizzamenti non vengono mai seguiti.

Mettere in pausa un avviso

Togli la spunta a Send messages. La scheda mostra Off e l’avviso resta.

Password e token

Salvati cifrati, poi mostrati come Stored (salvato). Lascia il campo vuoto per tenerlo. Se punti un avviso a un altro server, scrivi di nuovo il segreto; un segreto salvato non va mai in un posto nuovo.

Se non funziona

Sintomo:

Paste the Discord link

Causa: il link non inizia con https://discord.com/. Soluzione: copia di nuovo il link del webhook. Per un server di tipo Discord a casa, attiva Reach the local network (raggiungi la rete locale).

Sintomo:

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

Causa: il server è su questo computer o sulla tua rete di casa. Soluzione: attiva Reach the local network.

Sintomo: Last try failed (ultimo tentativo fallito) con una risposta 401 o 404. Causa: il link o il token è sbagliato. Questi errori non vengono ritentati. Soluzione: correggilo e premi Send a test.

Sintomo: la persona che ha richiesto non ha ricevuto nulla. Causa: nessun indirizzo email o ID utente Discord sul suo account, il momento non è spuntato, oppure ha disattivato i nuovi episodi. Soluzione: controlla questi tre punti.

Per esperti

Nuovi tentativi

Un timeout, una risposta di rallentamento o un errore del server vengono ritentati dopo 5 s, 30 s e 2 min. Un’attesa più lunga chiesta dal server viene rispettata, fino a 5 min. Un rifiuto, come un link sbagliato, non viene ritentato. Ogni errore aggiunge alla Cronologia una riga “Alert could not be sent”.

Tipi in sospeso e i loro campi

Mostrati solo con l’interruttore alert_channels_more attivo.

Tipo	Campi
Telegram	Bot token da @BotFather, Chat ID (ID di utente, gruppo o canale, oppure @channel). Scrivi prima al bot o aggiungilo al gruppo
ntfy	Server address (vuoto significa ntfy.sh), Topic, Access token facoltativo. Chiunque conosca il topic può leggerlo
Gotify	Server address, App token
Pushover	User key (funzionano anche le chiavi di gruppo), App token
Webhook (JSON)	Webhook link, Secret facoltativo, What the secret does

Cosa riceve un webhook

Un POST per messaggio, Content-Type: application/json, con questi header:

Header	Valore
X-HolyArrs-Event	Il momento, come import o test
X-HolyArrs-Delivery	ID casuale di questo messaggio
X-HolyArrs-Timestamp	Con Signs each message: secondi dal 1970
X-HolyArrs-Signature	Con Signs each message: sha256= più HMAC-SHA256 in esadecimale di <timestamp>.<delivery>.<body>, con il tuo segreto come chiave
Authorization	Con Is sent as a bearer token: Bearer <secret>

Con Nothing, non viene inviato nessun segreto. Quando firmi, rifiuta i timestamp vecchi e gli ID di consegna già visti, così un messaggio copiato non può essere riprodotto.

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

Altri campi compaiono quando servono: test, show ed episodes, artist e tracks, report, people. people contiene i nomi di chi ha richiesto, mai gli indirizzi. data contiene i motivi e i percorsi della riga di Cronologia dietro il messaggio. Qualsiasi risposta 2xx conta come consegnata.

Correlati

• Controlli di salute
• Approvare le richieste
• Utenti e ruoli