qbittorrent-orphaned is a lightweight utility that identifies orphaned files -- files that exist on disk but are not tracked by any torrent in your qBittorrent instance. It connects to the qBittorrent Web API v2, walks the directories you configure, cross-references every file against every torrent, and reports what does not belong.
Features
- One Python file whose only dependency is
requests. - Talks to the qBittorrent Web API v2, locally or over the network.
- Groups results by qBittorrent category, with uncategorized torrents under
__UNCATEGORIZED__. - Matches paths case-insensitively and prints each orphan with a readable size.
- Skips common metadata files (
.nfo,.jpg,.srtand others) and macOS._files. Add your own withIGNORE_SUFFIXES. - Filters known non-torrent files, such as transcoded copies, with
EXCLUDE_PATTERNS. - Only reports. It never deletes anything.
Quick start
pip install qbittorrent-orphaned
QBIT_HOST=http://localhost:8080 QBIT_USER=admin QBIT_PASS=yourpassword \
CATEGORY_FOLDERS="Films=/mnt/media/films;Shows=/mnt/media/shows" qbittorrent-orphaned
Docker and running the script directly are in Getting started.
Documentation
- Getting started: PyPI, running the script directly, Docker
- Configuration: environment variables, the
CATEGORY_FOLDERSformat, patterns that contain commas - How it works: what counts as an orphan, the steps, example output, feature details
License
Metadata
Release files for qbittorrent-orphaned 1.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| qbittorrent_orphaned-1.1.3.tar.gz | 26.3 kB | Without provenance | Details for qbittorrent_orphaned-1.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| qbittorrent_orphaned-1.1.3-py3-none-any.whl | Python 3 | none | any | Details for qbittorrent_orphaned-1.1.3-py3-none-any.whl |
Total release size: 46.5 kB
Release files / qbittorrent_orphaned-1.1.3.tar.gz
| Download URL | qbittorrent_orphaned-1.1.3.tar.gz |
|---|---|
| Size | 26.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c64c5bc32c910377a418f74eedf3da2aadb58a5050945d7817340918963f8338
|
|
BLAKE2b-256 checksum How to use checksums |
ad7f1245abb3fd32ae94ca3d18d88987051193c7601e8d252b16b0945e9abfb1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / qbittorrent_orphaned-1.1.3-py3-none-any.whl
| Download URL | qbittorrent_orphaned-1.1.3-py3-none-any.whl |
|---|---|
| Size | 20.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
063c8b046b55681b64b29dec99af39b6df09f0a6818f70efc505159d9beb00b3
|
|
BLAKE2b-256 checksum How to use checksums |
94748245877e8814c71c0175aea9e8e832dfeb6e0aaa29a7d68cb71d197055e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Security for qbittorrent-orphaned 1.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.