Qbit guard

A zero-dependency Python guard for qBittorrent that blocks pre-air TV episodes (Sonarr), deletes ISO/BDMV-only torrents, and auto-blocklists bad releases in…

  • Automation
  • Downloaders
  • Media Servers
A zero-dependency Python guard for qBittorrent that blocks pre-air TV episodes (Sonarr), deletes ISO/BDMV-only torrents, and auto-blocklists bad releases in Sonarr/Radarr (with dedupe + queue failover).

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

42/100 Fair

Maintained
40last commit 334 days ago
Popular
3342 GitHub stars
Easy to install
150 install platforms, install notes
Light to run
No data
Security check
85no serious findings, CI

Based on 4 of 5 factors.

GitHub stars
42
Open issues
4
Last commit
2025-12-22
Activity
stale

Checked 3 days ago - source: GitHub (GEngines/qbit-guard)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Start Docker and check logs Use the provided Docker Compose (the command that starts the app from a config file) to start it in the background, then keep the log output open. If the app fails to start, the logs show the error before you waste time on other settings. source
  • Fix Linux desktop package dependencies After installing the .deb (Linux package) desktop app, run the apt dependency-fix command shown in the docs. Missing Linux dependencies can stop the app from opening, and that command repairs them. source
  • Install the Python package with uv Install uv (a helper that installs Python command-line tools) first, then run the qbit-manage install command so the tool is placed on your system. Without uv, the install command fails, and without the tool you won't have a qbit-manage command to run. source
  • Docker image Use the project Docker image from ghcr.io/gengines/qbit-guard. source

Fetched 41 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Do I need a separate config file to set up qbit-guard in a container?

No, all configuration is done through environment variables, and it logs everything to stdout.

When does the pre-air gate stop new torrents?

For Sonarr it checks airDateUtc with configurable grace periods, and for Radarr it checks release dates with configurable grace periods.

What happens to ISO or BDMV-only torrents?

The ISO/BDMV cleaner removes disc-image-only torrents that lack keepable video content.

Does qbit-guard block bad releases in Sonarr or Radarr before deleting torrents?

Yes, it uses deduped history to blocklist in Sonarr or Radarr before deletion, with queue failover.

Can qbit-guard verify release information with external metadata APIs?

Yes, it has optional internet cross-verification using TVmaze and/or TheTVDB API integration.

Answers sourced from github.com

Community

Collected 48 days ago - public community threads