# Cross-seed-cleanup

Cross-seed-cleanup is a self-hosted tools & utilities app. Identifies torrents that are only used for cross-seeding and not hardlinked into a media library (Sonarr/Radarr). It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2739/cross-seed-cleanup

## Description

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.

## Health score

62/100 (Good), based on 4 of 5 factors.
- Maintained: 82 (last commit 25 days ago)
- Popular: 21 (10 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/mcreekmore/cross-seed-cleanup
- Unraid: https://ca.unraid.net/apps/cross-seed-cleanup-1npuu5y0y0q1pm?q=cross-seed-cleanup

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2739/cross-seed-cleanup), the self-hosted and open-source app directory.
