Vai al contenuto

FAQ / Troubleshooting

Primo avvio e configurazione

Messaggi rossi al primo avvio

Normale: il bot ha appena creato Unit3Dbot.json e i file di supporto con i valori segnaposto, e ti avvisa che mancano le chiavi. Segui i Primi passi.

-> Please Fix 'CAMPO' ['valore'] in settings.json

Un valore in Unit3Dbot.json è malformato (colore inesistente, numero non numerico, URL senza schema…). Apri il file e correggi il campo indicato tra apici. La Config completa elenca tipo e valori ammessi di ogni chiave.

No tracker name provided. Please update your configuration file

MULTI_TRACKER è vuoto. Serve almeno un tracker: "MULTI_TRACKER": ["itt"].

Tracker 'xyz' not found. Please update your configuration file

Il nome passato a -tracker non è nella lista MULTI_TRACKER (o non è tra i tracker supportati: itt, sis, ptt, ast).

Invalid multi-tracker list. Please remove duplicates

Lo stesso tracker compare due volte in MULTI_TRACKER.

-> No PID value for XXX_PID

Manca la passkey di un tracker presente in MULTI_TRACKER: o la configuri, o togli quel tracker dalla lista. Vedi Tracker.

Client torrent

Unknown Torrent Client name 'xxx'

TORRENT_CLIENT deve essere esattamente qbittorrent, transmission o rtorrent. Vedi Client torrent.

Il bot non si connette al client

  • WebUI attiva? (qBittorrent: Strumenti → Opzioni → WebUI)
  • Host e porta giusti? (QBIT_HOST/QBIT_PORT e equivalenti)
  • Credenziali corrette?
  • Il client gira su un'altra macchina/container? Allora serve anche SHARED_*_PATH (dettagli)

Upload senza client?

Sì: -noseed carica senza seeding, -noup crea solo il .torrent. Differenza: con -noseed il torrent arriva sul tracker, con -noup no — resta solo nell'archivio locale.

Dipendenze

ffmpeg non trovato

FFmpeg non è nel PATH. Windows · Linux: sudo apt install ffmpeg. Dopo averlo aggiunto al PATH, chiudi e riapri il terminale.

pdftocairo non riconosciuto

Poppler manca o non è nel PATH — serve solo per i PDF. Windows · Linux: sudo apt install poppler-utils.

Upload

There are no Media to process

Nel percorso non c'è niente che il bot riconosca come media, oppure il percorso è sbagliato o senza permessi di lettura.

Invalid -force category

Le categorie valide per -force sono: movie, tv, game, edicola.

Skipping game upload, no IGDB credentials provided

Mancano IGDB_CLIENT_ID / IGDB_ID_SECRET: i giochi vengono saltati, il resto prosegue. Vedi Giochi.

User tags file ... not found (con -b)

Manca tags_list.json nella cartella di configurazione. Viene creato al primo avvio: se l'hai cancellato, rilancia il bot senza argomenti. Vedi Tag e titoli.

Il titolo viene riconosciuto male

Usa -notitle "Titolo Corretto" per forzare la ricerca TMDB, e -b per ricostruire i tag. Vedi Tag e titoli.

Dove finiscono i .torrent creati?

In TORRENT_ARCHIVE_PATH, organizzati per tracker: <archivio>/ITT/nome.torrent. Default: Unit3Dup_config/torrent_archive_path/.

Watcher

Watcher path does not exist or is not configured

WATCHER_PATH non esiste o è rimasto no_path. Configura entrambi i percorsi del watcher (dettagli).

Altro

Il bot funziona su seedbox senza sudo?

Sì, con pyenv: guida Seedbox ultra.cc.

Come aggiorno?

pip install unit3dup --upgrade — Aggiornamento.

Dove chiedo aiuto?

Sul Discord di ITT o aprendo una issue su GitHub.