Skip to content

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:

upPollo upload /path/to/release --ignore-filters

The former skip_fully_aired and skip_bulk_releases options were removed: fully-aired handling is covered by release_date_grace_period, and bulk releases are always skipped. Remove them from your config if a deprecation warning appears.