mirror of
https://github.com/StuffAnThings/qbit_manage.git
synced 2025-10-12 14:56:22 +08:00
This tool will help manage tedious tasks in qBittorrent and automate them. Tag, categorize, remove Orphaned data, remove unregistered torrents and much much more.
7fd34aade4
Bumps [ruff](https://github.com/astral-sh/ruff) from 0.12.9 to 0.12.10. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/astral-sh/ruff/releases">ruff's releases</a>.</em></p> <blockquote> <h2>0.12.10</h2> <h2>Release Notes</h2> <h3>Preview features</h3> <ul> <li>[<code>flake8-simplify</code>] Implement fix for <code>maxsplit</code> without separator (<code>SIM905</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19851">#19851</a>)</li> <li>[<code>flake8-use-pathlib</code>] Add fixes for <code>PTH102</code> and <code>PTH103</code> (<a href="https://redirect.github.com/astral-sh/ruff/pull/19514">#19514</a>)</li> </ul> <h3>Bug fixes</h3> <ul> <li>[<code>isort</code>] Handle multiple continuation lines after module docstring (<code>I002</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19818">#19818</a>)</li> <li>[<code>pyupgrade</code>] Avoid reporting <code>__future__</code> features as unnecessary when they are used (<code>UP010</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19769">#19769</a>)</li> <li>[<code>pyupgrade</code>] Handle nested <code>Optional</code>s (<code>UP045</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19770">#19770</a>)</li> </ul> <h3>Rule changes</h3> <ul> <li>[<code>pycodestyle</code>] Make <code>E731</code> fix unsafe instead of display-only for class assignments (<a href="https://redirect.github.com/astral-sh/ruff/pull/19700">#19700</a>)</li> <li>[<code>pyflakes</code>] Add secondary annotation showing previous definition (<code>F811</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19900">#19900</a>)</li> </ul> <h3>Documentation</h3> <ul> <li>Fix description of global config file discovery strategy (<a href="https://redirect.github.com/astral-sh/ruff/pull/19188">#19188</a>)</li> <li>Update outdated links to <a href="https://typing.python.org/en/latest/source/stubs.html">https://typing.python.org/en/latest/source/stubs.html</a> (<a href="https://redirect.github.com/astral-sh/ruff/pull/19992">#19992</a>)</li> <li>[<code>flake8-annotations</code>] Remove unused import in example (<code>ANN401</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/20000">#20000</a>)</li> </ul> <h2>Contributors</h2> <ul> <li><a href="https://github.com/AlexWaygood"><code>@AlexWaygood</code></a></li> <li><a href="https://github.com/Avasam"><code>@Avasam</code></a></li> <li><a href="https://github.com/BurntSushi"><code>@BurntSushi</code></a></li> <li><a href="https://github.com/Cjkjvfnby"><code>@Cjkjvfnby</code></a></li> <li><a href="https://github.com/Gankra"><code>@Gankra</code></a></li> <li><a href="https://github.com/IDrokin117"><code>@IDrokin117</code></a></li> <li><a href="https://github.com/MatthewMckee4"><code>@MatthewMckee4</code></a></li> <li><a href="https://github.com/MichaReiser"><code>@MichaReiser</code></a></li> <li><a href="https://github.com/PrettyWood"><code>@PrettyWood</code></a></li> <li><a href="https://github.com/RazerM"><code>@RazerM</code></a></li> <li><a href="https://github.com/carljm"><code>@carljm</code></a></li> <li><a href="https://github.com/chirizxc"><code>@chirizxc</code></a></li> <li><a href="https://github.com/danparizher"><code>@danparizher</code></a></li> <li><a href="https://github.com/dcreager"><code>@dcreager</code></a></li> <li><a href="https://github.com/dhruvmanila"><code>@dhruvmanila</code></a></li> <li><a href="https://github.com/ericmarkmartin"><code>@ericmarkmartin</code></a></li> <li><a href="https://github.com/github-actions"><code>@github-actions</code></a></li> <li><a href="https://github.com/gkowzan"><code>@gkowzan</code></a></li> <li><a href="https://github.com/leandrobbraga"><code>@leandrobbraga</code></a></li> <li><a href="https://github.com/mtshiba"><code>@mtshiba</code></a></li> <li><a href="https://github.com/ntBre"><code>@ntBre</code></a></li> <li><a href="https://github.com/renovate"><code>@renovate</code></a></li> <li><a href="https://github.com/sharkdp"><code>@sharkdp</code></a></li> <li><a href="https://github.com/theammir"><code>@theammir</code></a></li> </ul> <!-- raw HTML omitted --> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Changelog</summary> <p><em>Sourced from <a href="https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md">ruff's changelog</a>.</em></p> <blockquote> <h2>0.12.10</h2> <h3>Preview features</h3> <ul> <li>[<code>flake8-simplify</code>] Implement fix for <code>maxsplit</code> without separator (<code>SIM905</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19851">#19851</a>)</li> <li>[<code>flake8-use-pathlib</code>] Add fixes for <code>PTH102</code> and <code>PTH103</code> (<a href="https://redirect.github.com/astral-sh/ruff/pull/19514">#19514</a>)</li> </ul> <h3>Bug fixes</h3> <ul> <li>[<code>isort</code>] Handle multiple continuation lines after module docstring (<code>I002</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19818">#19818</a>)</li> <li>[<code>pyupgrade</code>] Avoid reporting <code>__future__</code> features as unnecessary when they are used (<code>UP010</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19769">#19769</a>)</li> <li>[<code>pyupgrade</code>] Handle nested <code>Optional</code>s (<code>UP045</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19770">#19770</a>)</li> </ul> <h3>Rule changes</h3> <ul> <li>[<code>pycodestyle</code>] Make <code>E731</code> fix unsafe instead of display-only for class assignments (<a href="https://redirect.github.com/astral-sh/ruff/pull/19700">#19700</a>)</li> <li>[<code>pyflakes</code>] Add secondary annotation showing previous definition (<code>F811</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/19900">#19900</a>)</li> </ul> <h3>Documentation</h3> <ul> <li>Fix description of global config file discovery strategy (<a href="https://redirect.github.com/astral-sh/ruff/pull/19188">#19188</a>)</li> <li>Update outdated links to <a href="https://typing.python.org/en/latest/source/stubs.html">https://typing.python.org/en/latest/source/stubs.html</a> (<a href="https://redirect.github.com/astral-sh/ruff/pull/19992">#19992</a>)</li> <li>[<code>flake8-annotations</code>] Remove unused import in example (<code>ANN401</code>) (<a href="https://redirect.github.com/astral-sh/ruff/pull/20000">#20000</a>)</li> </ul> </blockquote> </details> <details> <summary>Commits</summary> <ul> <li><a href=" |
||
|---|---|---|
| .github | ||
| config | ||
| desktop/tauri | ||
| docs | ||
| icons | ||
| modules | ||
| scripts | ||
| web-ui | ||
| .dockerignore | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| activate.sh | ||
| CHANGELOG | ||
| deactivate.sh | ||
| Dockerfile | ||
| LICENSE | ||
| Makefile | ||
| pyproject.toml | ||
| qbit_manage.py | ||
| README.md | ||
| ruff.toml | ||
| setup.py | ||
| SUPPORTED_VERSIONS.json | ||
| uv.lock | ||
| VERSION | ||
qBit Manage
This is a program used to manage your qBittorrent instance such as:
- Tag torrents based on tracker URLs
- Apply category based on
save_pathto uncategorized torrents in category'ssave_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
--runcommand 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
Develop
Getting Started
Check out the wiki for installation help
- 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.
- 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.
- 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-managechannel. - 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.