Skip to content

CLI reference

Run upPollo --help for the built-in help of any command. The global -c, --config <path> flag selects a custom config file for every command:

upPollo -c /path/to/config.yaml upload /path/to/release

Commands

Command Purpose
upload [path] Identify, validate, and upload a release
config generate [path] Write a default config file
config validate Check config syntax and test connectivity to configured services
config migrate [path] Add newly introduced config options to an existing config
serve Run the HTTP API server (API mode)
update Self-update to the latest release
version Print the version
completion <shell> Generate shell completion scripts

Config commands are described in Configuration.

upload

upPollo upload [path] [flags]

path points to the media file or release directory itself; ., .. and / are rejected because upPollo names its temp directory after the release. For library uploads, point at a specific movie or season folder — not the library root (see Media library integration).

General flags

Flag Description
-u, --unattended Skip confirmation prompts (at your own risk; AnimeWorld requires --mal)
--allow-sd Allow SD for this unattended upload after verifying that no HD release exists
-f, --ignore-filters Disable upload filters for this upload
-d, --ignore-dupe Skip the dupe check for this upload
-n, --skip-name-enrichment Skip name enrichment (only dots are replaced)
-t, --tracker <list> Target tracker(s), comma-separated: rhd, aw, or rhd,aw
-r, --dry-run Validate without uploading (see Dry runs)
-j, --json Output dry-run results as JSON (requires --dry-run)

SD uploads are only allowed when no HD release exists. Unattended uploads block SD (480p/i, 540p, 576p/i) by default, including DVD releases. After checking that no HD release exists, explicitly allow SD for that upload:

upPollo upload --unattended --allow-sd "/path/to/Movie.2024.German.576p.DVDRip.x264-GROUP"

--ignore-filters, --ignore-dupe and --trump do not grant SD permission. Interactive uploads keep their normal confirmation flow; you must still verify that no HD release exists. upPollo does not check HD availability automatically.

Name enrichment

RocketHD builds the release name from database metadata and MediaInfo. Film and series titles come from TMDb independently of audio track order. For media files, the audio codec and channel count come from the first German audio track when available, even if an English track is first or marked as default. German language codes (de, deu, ger), names, and regional tags such as de-DE are recognized. If no German audio is present, the first audio track is used.

AnimeWorld keeps the original release name. Use --skip-name-enrichment to keep the original name on RocketHD as well, with dots replaced by spaces.

How a release is identified

Without --imdb or --tmdb, upPollo looks for an ID in the media file's Matroska tags, then in the NFO (an IMDb link, or a TVmaze link it translates to IMDb), then on XREL, SRRDB and CrowdNFO. Only when none of them has one does it search TMDb by the title in the release name. A search result scoring below fuzzy_score_cutoff needs your confirmation, and in unattended mode the release is skipped.

An ID upPollo found itself is checked against the release name. The title in the name has to roughly match one of the names TMDb lists for that film or show: the German, English, original or an alternative title, each also without its subtitle (CSI matches CSI: Crime Scene Investigation). This catches an NFO that links another film first, or Matroska tags carried over from another release. Below a title score of 50 out of 100, upPollo asks whether the identification is right. In unattended and API mode the release is skipped with a message like:

ID found via NFO (IMDb tt1517268, TMDb 346698) names 'Barbie' (2023), which does not match the release name (Score: 17.53 < 50.00)

Pass the right ID with --imdb or --tmdb in that case. An ID you pass is not checked, and upPollo then reads no ID from the Matroska tags, the NFO or the sites above. From the tags it only takes whether the release is a film or a show, and only when they name the ID you passed. For a show whose release name has no season (S01) and whose tags don't name your ID, add --force-tv. In interactive mode, answering n asks for the right ID. The check is deliberately rough: another film of the same series can pass, such as John Wick for John.Wick.Chapter.4.

Identification flags

Flag Description
--imdb <id> Pass an IMDb ID (e.g. tt1234567) to skip external lookups
--tmdb <id> Pass a TMDb ID (numeric) to skip external lookups
--mal <id> Pass a MyAnimeList ID (AnimeWorld; looked up via the MyAnimeList API if omitted, needs mal_client_id)
--force-tv Force the TV category if the release was wrongly detected as a movie (also sets season to 1)

Upload flags

Flag Description
-a, --anon Upload anonymously
-p, --personal-release Flag as personal release. Usually unnecessary — configure release groups instead
-i, --internal Flag as internal. Only honored on trackers that support it (currently RocketHD) and only with a privileged account role; otherwise ignored with a warning
-q, --modq Opt in to the moderation queue
--trump <id> Trump an existing RocketHD torrent by its numeric ID (the last number in the torrent URL). The upload goes to the mod queue and the dupe check is skipped
-C, --crc Verify the media file's CRC32 against SRRDB (scene releases only); the upload aborts on mismatch. Independent of this flag, the release folder and MKV filenames are always corrected to the scene name and NFO files are always verified/replaced
--delay <seconds> Wait at least this long between a torrent's upload and adding it to your client. Without a delay each torrent goes to the client right after its own upload; with a delay, at the first upload after its delay has passed, or at the end of the run. The other trackers' uploads don't wait for it
--keep-temp Preserve the temporary upload directory after completion or failure

Torrent client flags

Flag Description
--category <name> Category for the added torrent (overrides the config default). qBittorrent uses a native category; rTorrent, Deluge, and Transmission use labels
-T, --tags <tag> Tags for the added torrent (repeatable; overrides the config default). Supported by qBittorrent and Transmission; ignored by rTorrent and Deluge
--check-hash Force a hash check when adding the torrent (overrides the client's hash_check config)
--qbit-auto-tmm Enable automatic torrent management (qBittorrent only)

Examples

# Unattended, anonymous, with a known IMDb ID
upPollo upload "/path/to/movie.mkv" --unattended --anon --imdb tt1234567

# Upload an anime season to both trackers
upPollo upload "/path/to/anime/" --tracker rhd,aw --mal 12345

# Replace an existing torrent (trump)
upPollo upload "/path/to/fixed-release/" --trump 12345 --unattended

# Tag and categorize in qBittorrent
upPollo upload "/path/to/release/" --category movies -T uploaded -T rockethd

Dry runs

--dry-run runs the full validation pipeline — release identification, filter checks, and dupe checks — without creating or uploading anything. The MyAnimeList lookup for AnimeWorld is skipped, because it only matters for the upload itself:

upPollo upload --dry-run [path]
upPollo upload --dry-run --json [path]   # machine-readable output

Exit codes:

Code Meaning
0 The upload would succeed, or seed an existing dupe with seed_on_dupe
2 Blocked by filters or dupes
1 Any other error

With seed_on_dupe, a dry run downloads the .torrent of a dupe into the temp directory to verify your files against it.

Dry runs accept the same identification flags as a normal upload (--imdb, --tmdb, --unattended, --skip-name-enrichment, …).

Use --dry-run --unattended to check the automatic upload restrictions. SD is rejected unless --allow-sd is also set, matching an actual unattended upload.

The former upload check subcommand is deprecated and hidden; it now simply runs upload --dry-run.

Disc uploads (Blu-ray and DVD)

upPollo uploads complete Blu-ray and DVD folders, including release directories that contain one Blu-ray ISO or one DVD ISO/IMG image, and season packs with one Blu-ray ISO per disc directory. Point it at the release folder as usual:

upPollo upload "/path/to/Movie.2024.MULTi.COMPLETE.UHD.BLURAY-GROUP"

upPollo detects BDMV and VIDEO_TS structures, generates the appropriate BD info or MediaInfo, creates screenshots from the selected main feature, preserves the disc structure in the torrent, and sets the upload type to Complete Disc.

See Full disc uploads for supported layouts, playlist and title selection, ISO/IMG handling, FFmpeg requirements, temporary disk usage, and troubleshooting.