Sorgente, librerie e schema dei nomi decidono dove finiscono i file e come si chiamano. Ogni sezione si salva da sé.
Sorgente
Il dominio da cui il pannello cerca e scarica. Salvando viene verificato.
Altri host
Anche AnimeUnity e il server video cambiano dominio. Il server video viene letto dalla sorgente a ogni download; impostalo qui solo se la sorgente continua a indicarne uno che non risponde. Un campo vuoto torna al comportamento automatico. Salvando ogni host viene verificato.
Recupero automatico
Il dominio della sorgente cambia ogni poche settimane. Il pannello può accorgersene e proporre quello nuovo, dopo averlo verificato.
Il dominio viene letto da una pagina esterna che non controlliamo. Vengono presi in considerazione solo domini di secondo livello con un nome riconosciuto, e solo se rispondono davvero come la sorgente attesa. Con l’applicazione automatica attiva nessuno rilegge quella scelta prima che abbia effetto.
Librerie multimediali
Dove finiscono i file scaricati, una cartella per tipo di contenuto.
Su Docker serve il percorso interno al container, cioè
/app/videos/<cartella nel volume> — per esempio
/app/videos/Anime. Il percorso dell’host
(N:\Jellyfin\Anime, /srv/nfs/storage/Anime) va nel
docker-compose.yml, non qui: è la parte a sinistra dei due punti nel
volume montato su /app/videos.
Titoli e cartelle
Quale cartella della libreria contiene quale titolo. Il pannello le registra da solo a fine download, e riconosce le cartelle più vecchie della stessa serie salvate con un anno diverso. Qui si correggono: cambiare ID o cartella sostituisce l’associazione, e quella vecchia non viene più proposta. Nessun file viene spostato o rinominato.
Coppie corrette o rimosse. Il pannello non le ripropone; ripristinarne una la rende di nuovo riconoscibile in automatico.
Schema dei nomi
Come vengono chiamati cartelle e file. Segnaposto disponibili:
{title}, {year}, {season},
{season2} (con lo zero), {episode},
{episode2} (con lo zero). Quello che sta fra parentesi quadre compare
solo se i segnaposto al suo interno hanno un valore: [ ({year})] sparisce
del tutto quando l’anno non è noto.
I valori suggeriti nei campi sono quelli predefiniti e seguono la struttura
raccomandata dalla documentazione ufficiale di Jellyfin:
Film (2020)/Film (2020) e
Serie (2019)/Season 01/Serie S01E01, con l’estensione decisa dal
formato di uscita. Cambiali solo se la tua libreria
segue una convenzione diversa: Jellyfin riconosce quella sopra senza configurazione.
I file già scaricati non vengono rinominati. Continuano a essere riconosciuti come presenti, quindi non verranno riscaricati, ma restano con il nome vecchio finché non li rinomini dal gestore file.
Film
Serie TV
Anime
Download
Formato di uscita
In quale contenitore finiscono i file scaricati, e dove finiscono i sottotitoli. Il video non viene mai ricodificato: la sorgente è già H.264 con audio AAC, che entrambi i contenitori reggono così come sono, quindi cambiare questa impostazione non allunga di un secondo i download.
mov_text, che perde
colori, grassetti e posizionamento. I file separati evitano la conversione:
Jellyfin li riconosce lo stesso, perché prendono il nome del video.
I file già scaricati non vengono convertiti: restano nel contenitore con cui sono stati creati, e continuano a contare come presenti, quindi non verranno riscaricati da soli. Se invece riscarichi un titolo di proposito, la copia nel vecchio contenitore viene sostituita, non affiancata.
Accesso e utenti
Il pannello sta funzionando senza Jellyfin: nessun login, nessuna coda richieste, nessuna gestione utenti. Collegalo per abilitarli.
Collegato a
Chi sta usando il pannello senza login dovrà accedere di nuovo dopo l'aggiornamento. Puntare a un server Jellyfin diverso renderà orfani gli utenti già importati.
Notifiche
Inoltra le notifiche del pannello a Discord, Telegram, ntfy, email e altri servizi.
Un canale è una URL Apprise, ad esempio
discord://id_webhook/token_webhook oppure tgram://token_bot/id_chat.
Elenco completo dei servizi e formato delle URL.
Questi canali sono del pannello, non del singolo utente: ricevono gli eventi di tutti, comprese le richieste e i download avviati da altri. Pensali come un canale di amministrazione — un webhook su un canale Discord privato, non un gruppo condiviso con chi usa il pannello. Con «Tutti gli eventi» attivo su una libreria usata da più persone il volume può essere notevole: conviene scegliere solo gli eventi che ti interessano davvero.
Libreria Jellyfin
A fine download il pannello può chiedere a Jellyfin di aggiornare la libreria, invece di aspettare la sua scansione periodica.
Webhook
Una chiamata HTTP quando un download finisce. Nel corpo si possono usare
{title}, {path}, {status}, {type},
{season}, {episode}, {year} e
{error}. Con il corpo vuoto viene inviato un JSON con tutti i campi.
Un webhook può puntare anche a servizi della rete locale. Il pannello non restituisce mai la risposta ricevuta, solo l’esito: chi configura un hook sa se ha funzionato, non cosa ha risposto l’altro capo.
Nuove versioni
Il pannello chiede a GitHub se esiste una versione più recente, all’avvio e poi ogni 6 ore. Se c’è, accanto al numero di versione nella barra laterale compare un badge che apre le note di rilascio. Il controllo non installa nulla.
Server MCP
Permette a un agente AI (Claude Code, Cursor, …) di cercare titoli, avviare
download, seguire serie e gestire le richieste. Il server risponde all’indirizzo
del pannello, sotto /mcp: nessuna porta in più da aprire.
L’agente agisce come l’utente che ha generato il token, con i suoi permessi: chi ha il token può fare tutto ciò che quell’utente può fare.
Token
Configurazione del client
Trasporto Streamable HTTP, con il token nell’header Authorization.
Dietro un reverse proxy usa l’indirizzo pubblico del pannello, in HTTPS.
Cerca nel catalogo, scegli audio e sottotitoli, e mandalo in libreria.
Ogni download attraversa le sue fasi in ordine — video, una traccia per lingua audio, poi l'unione. La barra segue i segmenti ottenuti.
La libreria come la vede Jellyfin. Trascina una riga su una cartella per spostarla; i nomi seguono i template in Impostazioni → Nomi.
Approvare risolve di nuovo il titolo e verifica le tracce prima di scaricare: una richiesta che non trova l'audio chiesto viene messa da parte, non sostituita.
Cosa hai chiesto e a che punto è. Una richiesta si può ritirare finché non è stata risolta.
I nuovi episodi vengono cercati da soli. Una serie seguita non scarica mai da sé: apre una richiesta, che passa dalla coda o viene approvata subito, secondo i permessi di chi la segue.
Gli account arrivano da Jellyfin; il pannello decide solo cosa ciascuno può fare. I permessi sono indipendenti fra loro — non esiste un permesso di amministratore che implichi gli altri.
Tracce lette dall'ultimo episodio pubblicato. Vale per gli episodi che usciranno da ora in poi. Se la fonte non offre una traccia audio scelta, l'episodio viene fermato invece di essere scaricato senza.
Dopo la correzione, approva di nuovo la richiesta per riprovare.
Una cartella scelta qui decide anche dove finiscono i prossimi download di questo titolo. Nessun file viene spostato o rinominato.