Skip to content

Latest commit

 

History

355 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

Topics

Resources

Contributing

Stars

55 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages