cross-seed-cleanup

Overview

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.

Runtime arguments

Network: bridge
Shell: bash
Privileged: false

Template configuration

/dataPathro

Path to your torrent data. Must match the paths qBittorrent uses.

Default: /mnt/user/data
Value: /mnt/user/data

QB_HOSTVariable{3}

qBittorrent Web UI host (IP or hostname).

Default: localhost
Value: localhost

QB_PORTVariable{3}

qBittorrent Web UI port.

Default: 8080
Value: 8080

QB_USERNAMEVariable{3}

qBittorrent Web UI username.

Default: admin
Value: admin

QB_PASSWORDVariable{3}

qBittorrent Web UI password. Required unless QB_API_KEY is set.

QB_API_KEYVariable{3}

qui API key for proxy authentication. Use this instead of QB_USERNAME/QB_PASSWORD.

TAG_REMOVABLEVariable{3}

Tag applied to torrents that can be safely removed.

Default: cross-seed-only
Value: cross-seed-only

EXCLUDE_TAGSVariable{3}

Comma-separated tags to skip (torrents with these tags are never marked removable).

Default: pinned,keep
Value: pinned,keep

EXCLUDE_CATEGORIESVariable{3}

Comma-separated categories to skip entirely.

INCLUDE_CATEGORIESVariable{3}

Comma-separated categories to check. If empty, all categories are checked.

MIN_AGE_DAYSVariable{3}

Only tag torrents older than this many days. 0 to disable.

Default: 0
Value: 0

SCHEDULEVariable{3}

Cron expression for scheduled runs (e.g. '0 */6 * * *' for every 6 hours). If empty, runs once and exits.

RUN_ON_STARTVariable{3}

Run immediately on container start before entering the cron schedule. Only applies when SCHEDULE is set.

Default: true
Value: true

DRY_RUNVariable{3}

Set to false to actually apply tags. When true, only reports what would be tagged.

Default: true
Value: true

Links

Template Support Registry Project

Details

Repository

ghcr.io/mcreekmore/cross-seed-cleanup:latest

Registry

https://github.com/orgs/mcreekmore/packages/container/package/cross-seed-cleanup

Last Updated2026-05-31

First Seen2026-02-10

Run cross-seed-cleanup on Unraid.

cross-seed-cleanup is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS