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:
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¶
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:
--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:
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 checksubcommand is deprecated and hidden; it now simply runsupload --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 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.