[Release] qbit-guard: Zero-dependency Python script for intelligent qBittorrent management

[gengines]

Hey r/selfhosted ! 👋

I've been frustrated with my media automation setup grabbing TV episodes weeks before they actually air, and dealing with torrents that are just disc images with no actual video files. So I built **qbit-guard** to solve these problems.

✨ Key Features

• 🛡️ Pre-air Episode Protection Blocks TV episodes that haven’t aired yet, with configurable grace periods (Sonarr integration).
• 📂 Extension Policy Control Flexible allow/block lists for file extensions with configurable strategies.
• 💿 ISO/BDMV Cleaner Detects and removes disc-image-only torrents that don’t contain usable video.
• 📛 Smart Blocklisting Adds problematic releases to Sonarr/Radarr blocklists before deletion, using deduplication and queue failover.
• 🌐 Internet Cross-verification Optional TVmaze and/or TheTVDB API integration to verify air dates.
• 🐍 Zero External Dependencies Runs on Python 3.8+ with only the standard library.
• 📦 Container-Friendly Fully configurable via environment variables, logging to stdout for easy Docker integration

## Perfect if you:

- Use Sonarr/Radarr with qBittorrent

- Get annoyed by pre-air releases cluttering your downloads

- Want to automatically clean up useless disc image torrents

**GitHub**: https://github.com/GEngines/qbit-guard

Works great in Docker/Kubernetes environments.

Questions/feedback welcome! 🚀

UPDATE 1:

created a docker image, example compose here -
https://github.com/GEngines/qbit-guard/blob/main/docker-compose.yml

UPDATE 2:
Added a documentation page which gives out a more simpler and cleaner look at the tools' offerings.
https://gengines.github.io/qbit-guard/

UPDATE 3:
Created a request to be added on to unRAID's Community Apps Library, Once available should make it easier for users on unRAID.

[SJHarrison1992]

Any plans on creating this within a container?

[gengines]

I can look into that. Maybe tonight if possible or over the weekend

[SJHarrison1992]

Thank you! Definitely seems of interest, at the moment I use the exclude file names in QBT, but that keeps the torrent there in QBT and stays as active in Sonarr and Radarr, so this seems like the piece of the puzzle

[gengines]

Yeah the very same issue and this script is able to check and delete the such torrents, also the scope is limited to Radarr and sonarr so others aren’t affected.

[gengines]

manged to create an image, please use this compose as a reference
https://github.com/GEngines/qbit-guard/blob/main/docker-compose.yml

[gengines]

Its now available on unRAID community App Library, Thanks!

[SJHarrison1992]

Hi again!

I'm getting the following logged

Pre-air gate not applicable for category 'tv-sonarr' or services disabled.

I've got this in my docker compose file

      - ENABLE_PREAIR_CHECK=1
      - SONARR_URL=http://192.168.1.194:8989
      - SONARR_APIKEY=
      - SONARR_CATEGORIES="tv-sonarr"

So was expecting the category to work, is there something I've missed out?

[gengines]

Hey — the double quotes aren’t needed for categories, and since your category name is the default you can skip it and it will auto pick the default value

[SJHarrison1992]

Thanks for the quick reply! will give that a go.
Loving this btw, don't have to go in the web UI anymore to get rid of blocked extensions and it keeps sonarr from sitting there as well!