[GH-ISSUE #45] Add qbittorrent-orphaned — Find and remove orphaned qBittorrent files #29

New issue

Open

opened 2026-05-07 00:01:03 +02:00 by BreizhHardware · 0 comments

BreizhHardware commented

2026-05-07 00:01:03 +02:00

Owner

Originally created by @GeiserX on GitHub (Mar 8, 2026).
Original GitHub issue: https://github.com/miantiao-me/awesome-homelab/issues/45

App Info

Name: qbittorrent-orphaned
URL: https://github.com/GeiserX/qbittorrent-orphaned
Description: Python CLI tool that finds and removes orphaned files from qBittorrent downloads — files on disk no longer tracked by any torrent. Connects to qBittorrent's Web API to compare tracked files against what exists on disk.

Category: Download
License: GPL-3.0
Tech Stack: Python, qBittorrent Web API, Docker

Key Features

Detects files on disk not tracked by any active torrent in qBittorrent
Connects via qBittorrent Web API for accurate torrent-to-file mapping
Supports dry-run mode to preview orphaned files before deletion
Reclaims wasted disk space from stale or removed torrents
Docker-based deployment for easy homelab integration
Configurable via environment variables

Why it's useful for homelab users

Homelab users running qBittorrent often accumulate orphaned files — downloads that remain on disk after their corresponding torrents are removed. Over time, these orphaned files waste significant storage. This tool automates the detection and cleanup process by comparing disk contents against qBittorrent's active torrent list via its Web API, helping keep download directories clean and storage usage under control.

Originally created by @GeiserX on GitHub (Mar 8, 2026). Original GitHub issue: https://github.com/miantiao-me/awesome-homelab/issues/45 ## App Info **Name:** qbittorrent-orphaned **URL:** https://github.com/GeiserX/qbittorrent-orphaned **Description:** Python CLI tool that finds and removes orphaned files from qBittorrent downloads — files on disk no longer tracked by any torrent. Connects to qBittorrent's Web API to compare tracked files against what exists on disk. **Category:** Download **License:** GPL-3.0 **Tech Stack:** Python, qBittorrent Web API, Docker ## Key Features - Detects files on disk not tracked by any active torrent in qBittorrent - Connects via qBittorrent Web API for accurate torrent-to-file mapping - Supports dry-run mode to preview orphaned files before deletion - Reclaims wasted disk space from stale or removed torrents - Docker-based deployment for easy homelab integration - Configurable via environment variables ## Why it's useful for homelab users Homelab users running qBittorrent often accumulate orphaned files — downloads that remain on disk after their corresponding torrents are removed. Over time, these orphaned files waste significant storage. This tool automates the detection and cleanup process by comparing disk contents against qBittorrent's active torrent list via its Web API, helping keep download directories clean and storage usage under control.