Upload filters¶
Upload filters automatically skip releases that shouldn't be uploaded. They run on
every upload (CLI and API mode) and can be bypassed for a single upload with
-f, --ignore-filters — except in API mode, where filters are always enforced.
SD uploads in automation¶
SD uploads are only allowed when no HD release exists. API and unattended CLI
uploads therefore block SD (480p/i, 540p, 576p/i, including DVD releases) by default.
After verifying that no HD release exists, opt in for the individual upload with
--allow-sd or AllowSD: true.
upPollo does not check HD availability automatically.
The final SD check reads the video dimensions independently of the release name
and recognizes complete DVDs as SD. It checks both dimensions so cropped HD video
is not rejected just because its height is below 720 lines. upPollo recognizes a
complete DVD by its VIDEO_TS folder or disc image before identification, so it
is rejected before any lookup and before its main title is extracted.
This restriction also applies to unattended dry runs and API upload checks. It is
independent of configurable filters: --ignore-filters, --ignore-dupe and
--trump do not bypass it. Allowing SD keeps the other checks in place.
Options¶
upload_filters:
skip_non_german: true
skip_banned_groups: true
skip_low_quality: true
release_date_grace_period: 3
use_german_air_dates: true
exclude_regex: ""
exclude_tags: ["cross-seed"]
exclude_source_trackers: []
| Option | Description |
|---|---|
skip_non_german |
Skip releases without "german" (as a complete word) in the name |
skip_banned_groups |
Skip releases from banned groups (current list in the example config) |
skip_low_quality |
Skip low-quality releases (cam, ts, ld, md, upscale as complete words) |
release_date_grace_period |
Days (0–7) after a season finale during which uploads are still allowed — see below |
use_german_air_dates |
When the TVDB/TMDB (US) dates would skip an upload, check the German broadcast schedule on fernsehserien.de, which can still allow it (see below) |
exclude_regex |
Skip releases matching this regex (e.g. ".*REPACK.*") |
exclude_tags |
Skip releases whose source torrent carries any of these tags |
exclude_source_trackers |
Skip releases coming from these source trackers (when invoked via info hash from qBittorrent) |
When filters run¶
Filters that only need the release name and the source torrent's data in the torrent
client — target tracker, exclude_tags, exclude_source_trackers,
skip_banned_groups, skip_low_quality, exclude_regex and the german.subbed
case of skip_non_german — are checked before upPollo touches the content. A release
that fails one of them is skipped without creating links, MediaInfo, or a BDInfo scan,
so re-uploading a disc you already seed on the target tracker no longer reads the
whole ISO first.
The remaining checks need the media itself and run after MediaInfo/BDInfo: the
skip_non_german fallback that looks for a German audio track in releases without a
German tag, and the rejection of releases without any audio track.
Release date and finale handling¶
For TV episode releases, upPollo checks the season's air dates on TVDB and TMDB, and on TVmaze when neither of them has data for the season. It skips uploads of seasons that finished airing a while ago:
- Season still airing — upload allowed.
- Finale aired within the grace period — upload allowed, for all episodes of the season.
- Finale aired outside the grace period — upload skipped, for all episodes of the season. The check applies to the entire season, so even an early episode (say, episode 3 of 10) is skipped once the finale is older than the grace period. This prevents uploading outdated episodes from completed seasons.
- Bulk releases (all episodes aired the same day, typical for Netflix/Prime) — always skipped, regardless of the grace period.
- Air dates not verifiable — upload allowed, with a warning.
TVDB and TMDB sometimes number a show's seasons differently than the releases do. Netflix shows released in parts are a common case: TMDB lists Lupin Part 4 as season 3, while the releases call it S04. When TVDB or TMDB has no episodes for the season or can't be reached, upPollo asks TVmaze, which numbers seasons the way scene releases do. upPollo takes the show's TVmaze ID from the release's NFO, or looks the show up on TVmaze by its IMDb or TVDB ID. TVmaze has no finale flag, so a season only counts as finished once the episode matching its announced episode count has aired; until TVmaze announces that count, the season counts as still airing. If TVmaze doesn't know the season either, the air dates are not verifiable.
TVDB, TMDB and TVmaze only know the original release, mostly the US broadcast or the streaming service's worldwide release. Since both trackers upPollo supports are German, upPollo by default also checks the German air dates on fernsehserien.de whenever the original dates would skip an upload or can't be verified. If the season is still airing in Germany, or its German finale is within the grace period, the upload is allowed even though the original dates say the season finished. In every other case the original result stands: when the German dates show a finished season or a bulk release, when fernsehserien.de has no match for the show or no German air dates for the season, when its episode guide ends before the release's episode (the site hasn't added all episodes yet), and when the request fails. When the original dates put every episode of the season on the same day, the German dates only count once one of them falls on another day: German dates on that day alone mean Germany got the same release, and the German dates missing for the other episodes may simply not be entered on fernsehserien.de yet.
The German dates can therefore only allow an upload, with one exception: when
neither TVDB, TMDB nor TVmaze can verify the season and fernsehserien.de lists every
episode of it on the same German date, the upload is skipped as a bulk release. A
season that looks finished on fernsehserien.de doesn't skip an upload on its own,
because the episode guide of a season still airing often ends at the last episode
aired so far. Set use_german_air_dates: false to use the original dates only.
The grace period defaults to 3 days and is capped at 7; higher values are reduced to
7 with a warning. Setting it to 0 allows uploads only from ongoing seasons.
To upload a bulk release or an old season anyway, bypass the filters for that upload:
The former
skip_fully_airedandskip_bulk_releasesoptions were removed: fully-aired handling is covered byrelease_date_grace_period, and bulk releases are always skipped. Remove them from your config if a deprecation warning appears.