Support Thread

---

🚀 What is qbit-guard?

qbit-guard is a zero-dependency Python tool designed to protect your media library by acting as a smart guardian for qBittorrent downloads.

It works seamlessly with Sonarr and Radarr to intelligently filter out problematic torrents before they clutter your storage.

---

✨ 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.

---

🖥️ Why Use qbit-guard on Unraid?

• Save Storage Space → Prevent wasted space on pre-release or unusable torrents.

• Improve Media Quality → Block junk releases automatically.

• Save Bandwidth → Stop downloads you’ll just delete anyway.

• Automate Your Workflow → Reduce manual cleanup with smart rules.

• Made for Unraid Dockers → Simple to set up alongside qBittorrent, Sonarr, and Radarr.

---

📚 Documentation & Resources

• 📖 Full Documentation: https://gengines.github.io/qbit-guard/

• 🐙 Source Code: https://github.com/GEngines/qbit-guard

---

💬 Support

Any and all questions/issues related to this app on Unraid can be asked here in this support thread.

Edited August 28, 2025Aug 28 by bmetpally
beautification

This looks interesting, i did a quick search on CA and see no template (unless im going blind!), any chance you will create a template for this, i see the docker compose/run commands:- https://gengines.github.io/qbit-guard/#quick-start-docker-run

EDIT - FWIW i created a container using the example docker compose and the script ran well so i have created a template for this, it can be found on CA shortly.

Thanks, This is my first app on unraid so it took few hrs before my CA request was approved and repository created, its now live on the CA library.

Edited August 29, 2025Aug 29 by bmetpally

Few changes have been made to add support of TMDB which is exclusive for Movies, more details are available in the https://gengines.github.io/qbit-guard

Notable ones:

• Added "Detailed" Logging option, to see whats being blocked when it occurs

• Added Radarr pre-air check as well, due to limitations with TVDB and Radarr, TMDB API is being used, which required API KEY to be provided for best results, if no API KEY is provided it will fallback to radarr api.

• TMDB API Support for Radarr

• Documentation revised to show new changes and additions.

• File Filters which selectively downloads files ensuring blocked extensions are not downloaded. ( No need to set up qbit torrent download filters anymore )

unRAID CA App has been updated to show the newer changes

Has anyone else been having this issue? This container was working perfectly before, but then it just randomly stopped.