Cross-seed-cleanup

Identifies torrents that are only used for cross-seeding and not hardlinked into a media library (Sonarr/Radarr).

  • Tools & Utilities
Identifies torrents that are only used for cross-seeding and not hardlinked into a media library (Sonarr/Radarr). Compares filesystem hardlink counts against qBittorrent torrent references to find reclaimable space.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

62/100 Good

Maintained
82last commit 25 days ago
Popular
2110 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 23 days ago

GitHub stars
10
Open issues
0
Last commit
2026-10-26
Latest release
v0.3.3
License
Apache-2.0
Activity
declining

Checked 7 days ago - source: GitHub (mcreekmore/cross-seed-cleanup)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install Rust first with rustup Use rustup (Rust's installer) to install Rust, and follow the on-screen prompts so its commands are added to your PATH (where the system finds commands). Cross depends on the Rust toolchain, so without it Cross cannot build or run builds. source
  • Install Cross with cargo binstall After Rust is ready, install Cross with cargo binstall (a helper that downloads prebuilt Rust binaries). This puts the cross command on your system, so you can start Cross builds instead of getting command-not-found errors. source
  • Add binfmt support for other CPUs If you may build or run programs for a different CPU (central processing unit) architecture, add binfmt support by running the Docker binfmt install command on the host. This lets Linux start binaries made for another CPU; without it, they may not run. source
  • Install from Unraid Available in the Unraid Community Applications store; after installing, configure it to connect to your qBittorrent instance and specify your media library paths so it can perform hardlink analysis. source

Fetched 33 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Why does cross-seed-cleanup use inode comparison instead of normal hardlink checks?

Cross-seeded torrents can hardlink to one another, so they may appear hardlinked even when no Sonarr or Radarr file points to them. The tool compares filesystem hardlink counts with the qBittorrent torrents referencing the same inodes. It then tags torrents whose files are only linked by other torrents.

Which qBittorrent credentials should I set?

Set QB_HOST and QB_PORT, then either QB_USERNAME and QB_PASSWORD, or QB_API_KEY for qui. Do not set both QB_PASSWORD and QB_API_KEY.

Is it safe to run immediately?

DRY_RUN is enabled by default and only reports results. Set DRY_RUN=false to apply the removable tag to matching torrents.

What mount must I provide?

Mount the torrent data as /data with read-only mode. The paths must match the paths qBittorrent uses.

Can I filter which torrents are checked?

Use INCLUDE_CATEGORIES and EXCLUDE_CATEGORIES to limit or skip categories, EXCLUDE_TAGS to skip tagged torrents, and MIN_AGE_DAYS to require a minimum torrent age.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads