Skip to content
github-actions[bot] edited this page Nov 3, 2026 · 16 revisions

qbt-rules

Stop babysitting your torrents. qbt-rules is a client-server automation engine that watches qBittorrent and reacts to events, on a schedule, or on demand β€” categorizing, tagging, cleaning up, and re-prioritizing torrents so you don't have to.

- id: delete-well-seeded-torrents
  meta:
    description: "Delete well-seeded torrents automatically"
  context: weekly-cleanup
  conditions:
    all:
      - field: info.ratio
        operator: ">="
        value: 2.0
  actions:
    - type: delete_torrent
      params:
        delete_files: false

That's a real, complete rule β€” no code, just YAML. A few things people actually use it for:

  • 🎬 Auto-categorize new downloads by name pattern the moment they're added
  • 🧹 Clean up anything that's hit ratio/seeding-time targets, on whatever schedule you want
  • πŸ”’ Block or quarantine unwanted file types before they finish downloading
  • πŸ“Š Enforce ratio rules on private trackers without checking in manually
  • ⏫ Re-prioritize the queue when something urgent lands

One Docker container, one YAML file, and qBittorrent does the rest. Get started in 5 minutes β†’

Table of Contents

🎯 qbt-rules

GitHub β€’ Releases


πŸ“š Getting Started

πŸ“– Core Concepts

πŸ”’ Security

πŸ”§ Configuration

πŸ†˜ Help & Support

πŸ§‘β€πŸ’» For Developers


πŸ”‘ Key Features

  • πŸš€ Client-server architecture (HTTP API + worker)
  • πŸ“¦ Persistent job queue (SQLite or Redis)
  • ♻️ Reusable references ($ref, ${vars.x})
  • πŸ–₯️ Web dashboard with a validating rules.yml editor
  • 🐳 Docker-first deployment

πŸ”— Quick Links

Clone this wiki locally