{"id":13495458,"url":"https://github.com/StuffAnThings/qbit_manage","last_synced_at":"2025-03-28T16:32:40.963Z","repository":{"id":37803297,"uuid":"340566132","full_name":"StuffAnThings/qbit_manage","owner":"StuffAnThings","description":"This tool will help manage tedious tasks in qBittorrent and automate them. Tag, categorize, remove Orphaned data, remove unregistered torrents and much much more.","archived":false,"fork":false,"pushed_at":"2024-10-28T00:54:47.000Z","size":1568,"stargazers_count":767,"open_issues_count":12,"forks_count":47,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-10-28T04:45:24.533Z","etag":null,"topics":["cross-seed","python","qbittorrent","torrent-management"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/StuffAnThings.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORTED_VERSIONS.json","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"bobokun"}},"created_at":"2021-02-20T05:01:47.000Z","updated_at":"2024-10-26T14:24:53.000Z","dependencies_parsed_at":"2023-10-16T08:43:38.292Z","dependency_job_id":"db81cde1-b72f-493f-9165-4394deaf4af6","html_url":"https://github.com/StuffAnThings/qbit_manage","commit_stats":null,"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StuffAnThings%2Fqbit_manage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StuffAnThings%2Fqbit_manage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StuffAnThings%2Fqbit_manage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/StuffAnThings%2Fqbit_manage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/StuffAnThings","download_url":"https://codeload.github.com/StuffAnThings/qbit_manage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222395857,"owners_count":16977637,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cross-seed","python","qbittorrent","torrent-management"],"created_at":"2024-07-31T19:01:34.948Z","updated_at":"2025-03-28T16:32:39.977Z","avatar_url":"https://github.com/StuffAnThings.png","language":"Python","readme":"# \u003cimg src=\"qbm_logo.png\" width=\"75\"\u003e qBit Manage\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/StuffAnThings/qbit_manage?style=plastic)](https://github.com/StuffAnThings/qbit_manage/releases)\n[![GitHub commits since latest release (by SemVer)](https://img.shields.io/github/commits-since/StuffAnThings/qbit_manage/latest/develop?label=Commits%20in%20Develop\u0026style=plastic)](https://github.com/StuffAnThings/qbit_manage/tree/develop)\n[![Docker Image Version (latest semver)](https://img.shields.io/docker/v/bobokun/qbit_manage?label=docker\u0026sort=semver\u0026style=plastic)](https://hub.docker.com/r/bobokun/qbit_manage)\n![Github Workflow Status](https://img.shields.io/github/actions/workflow/status/StuffAnThings/qbit_manage/latest.yml?style=plastic)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/StuffAnThings/qbit_manage/master.svg)](https://results.pre-commit.ci/latest/github/StuffAnThings/qbit_manage/master)\n[![Ghcr packages](https://img.shields.io/badge/ghcr.io-packages?style=plastic\u0026label=packages)](https://ghcr.io/StuffAnThings/qbit_manage)\n[![Docker Pulls](https://img.shields.io/docker/pulls/bobokun/qbit_manage?style=plastic)](https://hub.docker.com/r/bobokun/qbit_manage)\n[![Sponsor or Donate](https://img.shields.io/badge/-Sponsor_or_Donate-blueviolet?style=plastic)](https://github.com/sponsors/bobokun)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\nThis is a program used to manage your qBittorrent instance such as:\n\n* Tag torrents based on tracker URLs\n* Apply category based on `save_path` to uncategorized torrents in category's `save_path`\n* Change categories based on current category (`cat_change`)\n* Remove unregistered torrents (delete data \u0026 torrent if it is not being cross-seeded, otherwise it will just remove the torrent)\n* Recheck paused torrents sorted by lowest size and resume if completed\n* Remove orphaned files from your root directory that are not referenced by qBittorrent\n* Tag any torrents that have no hard links outside the root folder (for multi-file torrents the largest file is used)\n* 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.\n* RecycleBin function to move files into a RecycleBin folder instead of deleting the data directly when deleting a torrent\n* Built-in scheduler to run the script every x minutes. (Can use `--run` command to run without the scheduler)\n* Webhook notifications with [Notifiarr](https://notifiarr.com/) and [Apprise API](https://github.com/caronc/apprise-api) integration\n\n## Supported Qbittorrent Versions\n\nWe rely on [qbittorrent-api](https://pypi.org/project/qbittorrent-api/) to interact with Qbittorrent.\n\nGenerally 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.\n\n### Master\n\n![master - qBittorrent version](https://img.shields.io/badge/dynamic/json?label=master%20-%20qBittorrent\u0026query=master.qbit\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FStuffAnThings%2Fqbit_manage%2Fdevelop%2FSUPPORTED_VERSIONS.json\u0026color=brightgreen)\n\n![master - qbittorrent-api version](https://img.shields.io/badge/dynamic/json?label=master%20-%20qbittorrent-api\u0026query=master.qbitapi\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FStuffAnThings%2Fqbit_manage%2Fdevelop%2FSUPPORTED_VERSIONS.json\u0026color=blue)\n\n### Develop\n\n![develop - qBittorrent version](https://img.shields.io/badge/dynamic/json?label=develop%20-%20qBittorrent\u0026query=develop.qbit\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FStuffAnThings%2Fqbit_manage%2Fdevelop%2FSUPPORTED_VERSIONS.json\u0026color=brightgreen)\n\n![develop - qbittorrent-api version](https://img.shields.io/badge/dynamic/json?label=develop%20-%20qbittorrent-api\u0026query=develop.qbitapi\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2FStuffAnThings%2Fqbit_manage%2Fdevelop%2FSUPPORTED_VERSIONS.json\u0026color=blue)\n\n## Getting Started\n\nCheck out the [wiki](https://github.com/StuffAnThings/qbit_manage/wiki) for installation help\n\n1. Install qbit_manage either by installing Python 3.9.0+ on the localhost and following the [Local Installation](https://github.com/StuffAnThings/qbit_manage/wiki/Local-Installations) Guide or by installing Docker and following the [Docker Installation](https://github.com/StuffAnThings/qbit_manage/wiki/Docker-Installation) Guide or the [unRAID Installation](https://github.com/StuffAnThings/qbit_manage/wiki/Unraid-Installation) Guide.\n1. Once installed, you have to [set up your Configuration](https://github.com/StuffAnThings/qbit_manage/wiki/Config-Setup) by create a [Configuration File](https://github.com/StuffAnThings/qbit_manage/blob/master/config/config.yml.sample) filled with all your values to connect to your qBittorrent instance.\n1. Please refer to the list of [Commands](https://github.com/StuffAnThings/qbit_manage/wiki/Commands) that can be used with this tool.\n\n## Usage\n\nTo run the script in an interactive terminal with a list of possible commands run:\n\n```bash\npython qbit_manage.py -h\n```\n\n## Support\n\n* If you have any questions or require support please join the [Notifiarr Discord](https://discord.com/invite/AURf8Yz) and post your question under the `qbit-manage` channel.\n* If you're getting an Error or have an Enhancement post in the [Issues](https://github.com/StuffAnThings/qbit_manage/issues/new).\n* If you have a configuration question post in the [Discussions](https://github.com/StuffAnThings/qbit_manage/discussions/new).\n* Pull Request are welcome but please submit them to the [develop branch](https://github.com/StuffAnThings/qbit_manage/tree/develop).\n","funding_links":["https://github.com/sponsors/bobokun"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FStuffAnThings%2Fqbit_manage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FStuffAnThings%2Fqbit_manage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FStuffAnThings%2Fqbit_manage/lists"}