Upload base

I tre flag fondamentali: -u, -f, -scan. Tutti portano a termine l'intero processo — analisi, screenshot, ricerca metadata, creazione .torrent, upload sul tracker, seeding nel client.

`-u` — un singolo file

ittup -u "/home/ITT/upload/film.mkv"

Carica un file. Il bot lo analizza, ricava titolo e tag dal nome, crea il torrent.

`-f` — una cartella

ittup -f "/home/ITT/upload/nomecartella"

Crea un unico torrent con il contenuto della cartella, che prende il nome della cartella. Dentro può esserci un film o una serie: per il bot non fa differenza.

Usalo per: stagioni complete, film in più parti, contenuti con file di accompagnamento.

`-scan` — tutto il contenuto di un percorso

ittup -scan "/home/ITT/upload"

È -u e -f insieme: analizza ogni file e ogni cartella dentro il percorso (ricorsivamente) e processa tutto, un torrent per ogni elemento trovato. Gli elementi vengono caricati in ordine alfanumerico (E2 prima di E10).

Quanti contenuti alla volta?

Su cartelle molto grandi puoi limitare il numero di elementi processati con FAST_LOAD nelle Opzioni avanzate.

Modificatori

Si combinano con -u, -f e -scan:

Flag	Effetto
`-noup`	Crea solo il `.torrent` (nell'archivio), niente upload né seeding
`-noseed`	Upload sul tracker senza seeding: il torrent non viene consegnato al client
`-dup`	Controlla i duplicati sul tracker prima di caricare
`-personal`	Marca l'upload come personal release
`-fl25` `-fl50` `-fl75` `-fl100`	Carica in freeleech 25, 50, 75 o 100% (`--freeleech25`…). Il tracker lo applica solo se il tuo account può impostare il freeleech
`-int`	Carica come release internal (`--internal`)
`-force <categoria>`	Forza la categoria: `movie`, `tv`, `game`, `edicola` (senza argomento: `movie`)
`-notitle "<titolo>"`	Usa questo titolo per la ricerca su TMDB invece di quello ricavato dal nome del file
`-reseed`	Modalità reseed (Reseed)

-int e il freeleech richiedono il permesso

Il tracker applica -int e -fl25…-fl100 solo allo staff e ai membri di un gruppo internal: per gli altri account carica il torrent senza, e senza errori. Dopo l'upload il bot rilegge il torrent e ti avvisa se non sono stati applicati.

Caratteri rifiutati dal tracker

Il tracker rifiuta i torrent con file o cartelle che hanno : ? * < > | " \ nel nome, o che finiscono con un punto o uno spazio. Prima di creare il torrent il bot li rinomina su disco e scrive ogni rinomina nel log: Titolo: Sub diventa Titolo - Sub, gli altri caratteri vengono tolti. Trattini, punti esclamativi e gli altri caratteri restano.

File in seed altrove

Un file rinominato non viene più trovato dai client che lo stavano già seedando con il vecchio nome.

ID nel nome

Se il nome del file o della cartella contiene un ID, il bot lo usa invece di cercare il titolo su TMDB:

Matrix (1999) {imdb-tt0133093}.mkv
Matrix (1999) {tmdb-603}.mkv
Matrix (1999) [tmdbid-603].mkv
Matrix (1999) (tmdb-603).mkv
Matrix.1999.tt0133093.1080p.mkv

Il formato {imdb-tt…} è quello di Radarr, Sonarr e Plex, [tmdbid-…] quello di Jellyfin; vanno bene anche le parentesi tonde, = al posto del trattino (Emby) e l'ID IMDB da solo (tt0133093). Con il solo ID IMDB il bot chiede a TMDB l'ID TMDB corrispondente; con il solo ID TMDB ricava l'ID IMDB da TMDB. Entrambi vengono inviati al tracker. Il tag viene tolto dal titolo mostrato sul tracker.

Senza ID, il bot cerca su TMDB il titolo ricavato dal nome. Se non lo trova riprova con il nome completo prima dell'anno ((500) Days of Summer) e con i titoli tra parentesi (Lo Chiamavano Jeeg Robot (They Call Me Jeeg)), e infine con una tolleranza sull'anno: un anno di differenza per i film (uscite a fine anno), l'anno di una stagione successiva per le serie.

Esempio completo

ittup -dup -u "/home/parzival/TEST/scan/007 - Vivi e lascia morire (1973).mkv"

Analizza il file, costruisce titolo e tag, controlla i duplicati su ItaTorrents, lo carica e avvia il seeding.

Cosa vedi a schermo

Il bot mostra una tabella dei file in lavorazione, poi per ogni contenuto: ricerca TMDB, estrazione screenshot, upload immagini, creazione torrent, risposta del tracker, invio al client. La guida Primo upload passo-passo descrive ogni fase.