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…
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
Variants
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