Skip to content
Projects

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.

How these counts are measured

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-hosted

README.md

Original

auditorr

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

auditorr dashboard


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.


Media explorer

Media explorer
Tree or flat view of your library. Click a file to see every hardlink sibling and which tracker is seeding it.

Torrents

Torrents
Every file qBittorrent / qui is seeding, with tracker, status, and reverse hardlink lookup.

Trackers

Trackers
Configurable chart of per-tracker analytics. Deep-link into the explorer pre-filtered by tracker.

Change log

Change log
File-level diff between every consecutive audit, kept indefinitely.


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.

Rounds

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.

Backfill workflow

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.

Cleanup workflow

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.

Triage workflow

Dedupe

Targets duplicate files: review duplicate groups and generate a script that replaces copies with hardlinks, verified with cmp before linking.

Dedupe workflow

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.

Trumped workflow


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.