Skip to content

Full config reference

Every key of ittup.json, section by section. "Default" is the value in the file generated on first run; the no_key / no_pass / no_path placeholders mean "not configured".

tracker_config

Key Type Default Required Description
ITT_URL string https://itatorrents.xyz yes ITT tracker URL
ITT_APIKEY string no_key yes Your ITT profile API key
ITT_PID string no_key yes ITT passkey (used in the announce URL)
TMDB_APIKEY string no_key for videos TheMovieDB key
TVDB_APIKEY string no_key recommended for TV shows TheTVDB key
IMGBB_KEY string no_key at least one host ImgBB key
FREE_IMAGE_KEY string no_key at least one host FreeImage key
LENSDUMP_KEY string no_key at least one host LensDump key
PTSCREENS_KEY string no_key at least one host PtScreens key
IMGFI_KEY string no_key at least one host ImgFI key
PASSIMA_KEY string no_key at least one host PassIMA key
IMARIDE_KEY string no_key at least one host ImaRide key
YOUTUBE_KEY string no_key no YouTube Data API key (trailers)
IGDB_CLIENT_ID string no_key for games IGDB/Twitch Client ID
IGDB_ID_SECRET string no_key for games IGDB/Twitch Client Secret

torrent_client_config

Key Type Default Required Description
QBIT_USER string admin if using qBittorrent WebUI username
QBIT_PASS string no_pass if using qBittorrent WebUI password
QBIT_HOST string 127.0.0.1 if using qBittorrent Client host
QBIT_PORT number 8080 if using qBittorrent WebUI port
SHARED_QBIT_PATH string no_path no Path as seen by the client when it runs elsewhere
QBIT_SKIP_CHECK boolean True no Skip the hash check when adding the torrent
QBIT_ENABLED boolean True no False disables qBittorrent: no connection, no seeding
TRASM_USER string admin if using Transmission Username
TRASM_PASS string no_pass if using Transmission Password
TRASM_HOST string 127.0.0.1 if using Transmission Host
TRASM_PORT number 9091 if using Transmission Port
SHARED_TRASM_PATH string no_path no Path as seen by the client when it runs elsewhere
RTORR_USER string admin if using rTorrent Username
RTORR_PASS string no_pass if using rTorrent Password
RTORR_HOST string 127.0.0.1 if using rTorrent Host
RTORR_PORT number 9091 if using rTorrent Port
SHARED_RTORR_PATH string no_path no Path as seen by the client when it runs elsewhere
TORRENT_CLIENT string qbittorrent for uploads with seeding qbittorrent, transmission or rtorrent
TAG string ADDED TORRENTS no Label applied to torrents in the client

user_preferences

Key Type Default Description
PTSCREENS_PRIORITY number 0 Image host priority (0 = first)
LENSDUMP_PRIORITY number 1 LensDump priority
FREE_IMAGE_PRIORITY number 2 FreeImage priority
IMGBB_PRIORITY number 3 ImgBB priority
IMGFI_PRIORITY number 4 ImgFI priority
PASSIMA_PRIORITY number 5 PassIMA priority
IMARIDE_PRIORITY number 6 ImaRide priority
NUMBER_OF_SCREENSHOTS number 4 Screenshots extracted from the video (2–10)
TAGS_POSITION_MOVIE list see Options Tag order in movie titles (5–17 entries)
TAGS_POSITION_SERIE list see Options Tag order in TV show titles
YOUTUBE_PREF_LANG string IT Country/language code (ISO 3166) for the YouTube trailer search
DUPLICATE_ON boolean true Duplicate check on every upload
SKIP_DUPLICATE boolean false Skips duplicate content without asking
SKIP_TMDB boolean false Skips the TMDB lookup
SKIP_YOUTUBE boolean true Skips the YouTube trailer search
SIZE_TH number 10 Size difference % threshold for duplicate matching
WATCHER_INTERVAL number 60 Seconds between watcher checks
WATCHER_TIMEOUT number 3600 Max seconds the watcher spends on one file or folder before skipping it (0 = no limit)
WATCHER_PATH string no_path Folder watched by the watcher
WATCHER_DESTINATION_PATH string no_path Watcher file destination
WATCHER_QUARANTINE_PATH string no_path Folder of the failed watcher uploads
WATCHER_MAX_RETRIES number 5 Retries of an upload stopped by a temporary error
TORRENT_ARCHIVE_PATH string no_path Archive of the generated .torrent files
CACHE_PATH string no_path Cache folder
COMPRESS_SCSHOT number 3 Screenshot compression
RESIZE_SCSHOT boolean False Resizes screenshots
TIMEOUT_SCSHOT number 120 Max seconds for a single screenshot (0 = no limit)
TONEMAP_SCSHOT boolean False Tone maps the HDR screenshots to SDR
TORRENT_COMMENT string no_comment Comment inside the .torrent file
PREFERRED_LANG string all Preferred language (ISO 3166) or all
ANON boolean False Anonymous upload
WEBP_ENABLED boolean False Animated webp in the description
CACHE_SCR boolean False Screenshot cache
CACHE_DBONLINE boolean False Disk cache of the online lookups (TMDB/IMDB/TVDB/IGDB IDs)
TMDB_DEBUG boolean False Logs TMDB title-matching scores (extra HTTP requests)
PERSONAL_RELEASE boolean False Personal release on every upload
RENAME_FILES boolean False Renames the original files as the tracker title before the upload
CHECK_CORRUPTED boolean True Skips the corrupted video files, checked with ffprobe (5.1 or newer) before the upload
CHECK_CORRUPTED_START number 10 Start of the checked range, in percent of the duration
CHECK_CORRUPTED_END number 90 End of the checked range, in percent of the duration
CHECK_CORRUPTED_IGNORE_DV boolean False Dolby Vision RPU metadata errors don't make the file corrupted
FAST_LOAD number 0 Caps the processed items (1–150; 0 = all)
RELEASER_SIGN string empty Releaser signature (max 20 characters)

options

Key Type Default Description
FTPX_USER string user FTP username
FTPX_PASS string pass FTP password
FTPX_IP string 127.0.0.1 FTP server IP
FTPX_PORT number 2121 FTP port
FTPX_LOCAL_PATH string . Local download folder
FTPX_ROOT string . Remote starting folder
FTPX_KEEP_ALIVE boolean False Keeps the connection alive

console_options

Key Type Default Description
NORMAL_COLOR string blue bold Normal message color
ERROR_COLOR string red bold Error color
WELCOME_MESSAGE string https://itatorrents.xyz Welcome banner text
WELCOME_MESSAGE_COLOR string blue Banner color
WELCOME_MESSAGE_BORDER_COLOR string yellow Banner border
PANEL_MESSAGE_COLOR string blue Panel color
PANEL_MESSAGE_BORDER_COLOR string yellow Panel border
QUESTION_MESSAGE_COLOR string yellow Question color

Allowed colors: black, red, green, yellow, blue, magenta, cyan, white (+ bold).

Boolean values accept true/false, 1/0, yes/no (as strings or native).