Skip to content

About

An audit tool for hardlinked media libraries. The dashboard with health score, per-tracker analytics, and cross-seed effectiveness tells you what's wrong. Five automated workflows fix it.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

 
 

Latest commit

 

History

357 Commits

Folders and files

Repository files navigation

auditorr

An audit tool for hardlinked media libraries using qBittorrent / qui + Sonarr / Radarr. 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.

Configuration · Remote access · Troubleshooting

auditorr dashboard


What's new in 1.7.3

  • Every Sonarr / Radarr instance is read now (#22) - your primary pair and the Additional instances list are merged rather than either/or. Upgrading is the whole fix.
  • File Explorer can say "not" (#23) - Duplicates and Excluded get their own + / - toggles, so orphaned but not excluded is one click.
  • Workflow pages keep up - act on a row and the sidebar, dashboard and other pages follow straight away, instead of waiting for the next audit.
  • Rounds keeps score for a tidy library too - a dated record of every prize you've earned, eleven new ladders, and workflow prizes rebased onto work done rather than bytes held.

Upgrading from 1.7.0 or earlier? 1.7.1 closed off-LAN API access by default - LAN is unaffected.

What's new in 1.7.0

  • Optimized for large libraries - backend memory optimizations, tested on libraries up to 500 TB.
  • Four new workflows - Backfill is now joined by Cleanup, Triage, Dedupe, and Trumped, so every dashboard problem has a fix.
  • A rebuilt UI - a top-to-bottom design pass with consistent buttons and spacing, and a calmer library-health dial.

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 ranked list, in a fixed order you walk again and again: Baseline you clear once and then watch, Ongoing never has a last item, On demand waits for a tracker to ask. Under it sits a shelf of useless prizes — 650+ named tiers and 109 feats in the spirit of Progress Quest, awarded for work you were going to do anyway and never taken back — and a dated record of every one you've earned.

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. 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. Trigger a Sonarr/Radarr rescan, 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), removes it from the client with its files, and grabs the exact replacement through Sonarr/Radarr — 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.

About

An audit tool for hardlinked media libraries. The dashboard with health score, per-tracker analytics, and cross-seed effectiveness tells you what's wrong. Five automated workflows fix it.

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages