mirror/Cleanuparr
1
0
Fork 0
mirror of https://github.com/Cleanuparr/Cleanuparr.git synced 2026-06-30 00:05:58 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add dead torrent handling (#627)

Browse Source
This commit is contained in:
Flaminel
2026-06-14 02:14:10 +03:00
committed by GitHub
parent 1cc068c2ab
commit 7aa3224f4d
54 changed files with 4207 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
docs/docs/configuration/download-cleaner/index.mdx
View File

@@ -438,4 +438,60 @@ Categories to check for unlinked downloads. Only downloads in these categories w
</div>
<div className={styles.section}>
<SectionTitle>Dead Torrents</SectionTitle>
<p className={styles.sectionDescription}>
A dead torrent is one whose tracker reports no seeders for a prolonged period — typically because it was removed from the tracker, or the tracker host itself is gone — so it can never reach a ratio or seed-time threshold. Instead of deleting such torrents, this feature moves them to a target category (or adds a tag/label) so you can decide what to do next via a seeding rule for that category/tag. It runs as part of the Download Cleaner job. Configured per download client in the <strong>Dead Torrents</strong> accordion.
</p>
<Note>
A torrent is considered dead on a run when the client reports **no seeders** — a count of `0`, an unknown count (e.g. qBittorrent's `-1`), or no count at all because the tracker is unreachable. It is only moved after it has been dead for the configured number of consecutive runs (the strike count), and **strikes reset to zero as soon as the client reports seeders again**. Supported for **qBittorrent**, **Transmission**, **Deluge**, and **µTorrent** — not **rTorrent**, which does not report a seeder count.
</Note>
<ConfigSection
title="Enable Dead Torrent Handling"
>
When enabled, torrents in the configured categories that report no seeders for the configured number of consecutive runs are moved to the target category (or tagged). Create a seeding rule for that category/tag to control whether and when they are removed.
</ConfigSection>
<ConfigSection
title="Dead Torrent Target Category"
>
The category a dead torrent is moved to (or the tag/label added when **Use Tag** is enabled). Create a seeding rule for this category/tag to manage the moved torrents.
</ConfigSection>
<ConfigSection
title="Dead Torrent Use Tag"
>
When enabled, adds a tag/label instead of changing the category, preserving the original category. Supported by **qBittorrent** (tags) and **Transmission** (labels). For Transmission, changing the category (with this option off) moves the files on disk, whereas using a label does not.
</ConfigSection>
<ConfigSection
title="Dead Torrent Strikes"
>
The number of consecutive runs a torrent must report no seeders before it is moved. Minimum is `3`. Strikes reset to zero as soon as seeders are found again.
Set this **high enough to ride out tracker downtime** so a temporarily-unreachable tracker isn't mistaken for a dead one. Choose it together with the Download Cleaner schedule — with an hourly schedule, `24` ≈ one day and `168` ≈ one week of being continuously dead.
</ConfigSection>
<ConfigSection
title="Dead Torrent Categories"
>
Source categories to scan for dead torrents. Only downloads in these categories are checked. The target category must not be one of these.
</ConfigSection>
</div>
</div>