Skip to main content

This tool will help manage tedious tasks in qBittorrent and automate them. Tag, categorize, remove Orphaned data, remove unregistered torrents and much much more.

Project description

qBit Manage

GitHub release (latest by date) GitHub commits since latest release (by SemVer) Docker Image Version (latest semver) PyPi (latest semver) Github Workflow Status pre-commit.ci status Ghcr packages Docker Pulls Sponsor or Donate Ruff

This is a program used to manage your qBittorrent instance such as:

  • Tag torrents based on tracker URLs
  • Apply category based on save_path to uncategorized torrents in category's save_path
  • Change categories based on current category (cat_change)
  • Remove unregistered torrents (delete data & torrent if it is not being cross-seeded, otherwise it will just remove the torrent)
  • Recheck paused torrents sorted by lowest size and resume if completed
  • Remove orphaned files from your root directory that are not referenced by qBittorrent
  • Tag any torrents that have no hard links outside the root folder (for multi-file torrents the largest file is used)
  • Apply share limits based on groups filtered by tags/categories and allows optional cleanup to delete these torrents and contents based on maximum ratio and/or time seeded. Additionally allows for a minimum seed time to ensure tracker rules are respected and minimum number of seeders to keep torrents alive.
  • RecycleBin function to move files into a RecycleBin folder instead of deleting the data directly when deleting a torrent
  • Built-in scheduler to run the script every x minutes. (Can use --run command to run without the scheduler)
  • Webhook notifications with Notifiarr and Apprise API integration

Supported Qbittorrent Versions

We rely on qbittorrent-api to interact with Qbittorrent.

Generally expect new releases of Qbittorrent to not immediately be supported. Support CANNOT be added until qbittorrent-api adds support for the version. Any material changed and impact must then be assessed prior to Qbit Manage supporting it.

Master

master - qBittorrent version

master - qbittorrent-api version

Develop

develop - qBittorrent version

develop - qbittorrent-api version

Getting Started

Check out the wiki for installation help

  1. Install qbit_manage either by installing Python 3.9.0+ on the localhost and following the Local Installation Guide or by installing Docker and following the Docker Installation Guide or the unRAID Installation Guide.
  2. Once installed, you have to set up your Configuration by create a Configuration File filled with all your values to connect to your qBittorrent instance.
  3. Please refer to the list of Commands that can be used with this tool.

Usage

To run the script in an interactive terminal with a list of possible commands run:

python qbit_manage.py -h

Support

  • If you have any questions or require support please join the Notifiarr Discord and post your question under the qbit-manage channel.
  • If you're getting an Error or have an Enhancement post in the Issues.
  • If you have a configuration question post in the Discussions.
  • Pull Request are welcome but please submit them to the develop branch.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qbit_manage-4.6.4.tar.gz (694.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qbit_manage-4.6.4-py3-none-any.whl (726.6 kB view details)

Uploaded Python 3

File details

Details for the file qbit_manage-4.6.4.tar.gz.

File metadata

  • Download URL: qbit_manage-4.6.4.tar.gz
  • Upload date:
  • Size: 694.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qbit_manage-4.6.4.tar.gz
Algorithm Hash digest
SHA256 1b1859d01ec091f3c2ac44e29c685b880b4f543bb1ac036be0cf05c5ab3e9a33
MD5 ac638c92dda04f2a206e080b4665546a
BLAKE2b-256 20329bf4ef3642d1b154034120acbe73d3e6f68423fdb0750b87e3db11115a23

See more details on using hashes here.

Provenance

The following attestation bundles were made for qbit_manage-4.6.4.tar.gz:

Publisher: pypi-publish.yml on StuffAnThings/qbit_manage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qbit_manage-4.6.4-py3-none-any.whl.

File metadata

  • Download URL: qbit_manage-4.6.4-py3-none-any.whl
  • Upload date:
  • Size: 726.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for qbit_manage-4.6.4-py3-none-any.whl
Algorithm Hash digest
SHA256 d6a1669ee0c155115ab9a8b7731ccf3b36e64be46c9f48576fb1822c5944ae68
MD5 5440abd81296b57bbee753ef9bcbef25
BLAKE2b-256 83ee5ec7f0e44c59285361f3e19d4a0fd4ee504cbba0b2c6f7d54bbd09f1dfd8

See more details on using hashes here.

Provenance

The following attestation bundles were made for qbit_manage-4.6.4-py3-none-any.whl:

Publisher: pypi-publish.yml on StuffAnThings/qbit_manage

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page