thrill-burn/auditorr
thrill-burn/auditorr has 71 GitHub stars and 4 forks. GitHot measured 0 stars in 24 hours and +1 in 7 days. Last checked 2026-11-17 02:54 UTC. Last push 2026-11-08.
Measured star growth
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
An audit tool for hardlinked media libraries following TRaSH guides. The dashboard with health score, per-tracker analytics, and cross-seed effectiveness tells you what's wrong. Five automated workflows fix it.
Self-hostedREADME.md
Originalauditorr
An audit tool for hardlinked media libraries using qBittorrent / qui + Sonarr / Radarr, following the TRaSH Guides folder structure. A dashboard with health score, per-tracker analytics, and cross-seed effectiveness tells you what's wrong with your library. Five automated workflows fix it. Built to stay light on memory, it runs on 500+ TB libraries.
Configuration · Remote access · Troubleshooting
What's new in 1.8.3
- 1.8.2's CPU use is fixed - on a library with a few thousand folders or more, 1.8.2 could keep a CPU core busy for as long as it ran. If you're on 1.8.2, upgrade. Full list.
- Filter Triage and Cleanup (1.8.2) - narrow either list by search, size and age, and Triage also by tracker, seed time and ratio. An action only touches the rows you can see. Contributed by OrbitMPGH.
- A readable page width (1.8.2) - on a large monitor, Config → Appearance can keep pages to a laptop's width, so a row's title and its details stay together. Also from OrbitMPGH.
- Fixes (1.8.2) - messages, Import Jobs and the scan card stack instead of covering each other, a download's badge sits on the workflow that started it, and a crowded action bar wraps instead of pushing its last button out.
Upgrading needs no configuration changes. From 1.7.0 or earlier? 1.7.1 closed off-LAN API access by default - LAN is unaffected.
Workflows
The dashboard tells you what's wrong; workflows fix it. Rounds tells you which one to open.
Rounds
Every workflow in one list, in a fixed order: Baseline to clear and then watch, Ongoing that never runs out, and On demand for when a tracker asks. Underneath sit 750+ useless prizes in the spirit of Progress Quest, awarded for work you were going to do anyway and never taken back.
Backfill
Targets orphaned media: files on disk with no hardlink to a seeding torrent and no way to grow one (trumped, dead tracker, your own rip). Search the same title on the tracker you want, grab a version that actually seeds, and swap it in via Sonarr / Radarr.
Cleanup
Targets orphaned torrent files: files in your torrent folder the client has no torrent for, leftover hardlinks a removed cross-seed left behind, and empty folders. Review them grouped by release folder, then generate a reviewed delete script — or exclude the ones you put there on purpose.
Triage
Explains every problem torrent and what to do about it: dead seeds, dead registrations, unregistered, superseded quality, pending imports, and not in library. Retry or force an import, switch a finished season over to one pack, exclude, or delete torrents and their files directly through qBittorrent / qui.
Dedupe
Targets duplicate files: review duplicate groups and generate a script that
replaces copies with hardlinks, verified with cmp before linking.
Trumped
Automates the private-tracker trump swap. Paste the tracker's "this release has been trumped" PM; auditorr parses the old and new release names, finds the entire hardlink group (every cross-seed of the old content), grabs the exact replacement through Sonarr/Radarr, and only then removes the old group from the client with its files — wizard-style, confirmed at every step.
Install
Unraid
auditorr is on Unraid Community Apps — search for auditorr in the
Apps tab and install in one click.
- WebUI:
http://[IP]:[PORT:8677]/ - Appdata:
/mnt/user/appdata/auditorr/data→/app/data - Data:
/mnt/user/data→/data(read-only)
Docker Compose
services:
auditorr:
image: ghcr.io/thrill-burn/auditorr:latest
container_name: auditorr
restart: unless-stopped
ports:
- "8677:8677"
volumes:
- ./data:/app/data
- /path/to/media:/data/media:ro
- /path/to/torrents:/data/torrents:ro
Build from source
git clone https://github.com/thrill-burn/auditorr.git
cd auditorr
docker build -t auditorr .
docker run -d \
--name auditorr \
-p 8677:8677 \
-v /path/to/appdata:/app/data \
-v /path/to/media:/data/media:ro \
-v /path/to/torrents:/data/torrents:ro \
auditorr
Something not working? See Troubleshooting.
[!IMPORTANT] The Hardlinked Media score assumes you use hardlinks between your torrent folder and your media library — the TRaSH Guides folder structure. Without hardlinks, this score is 0 regardless of how healthy the rest of your library is.
License
MIT — see LICENSE.








