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

---

Fixed in 1.7.1

• Closed by default off-LAN - with no access key set, remote requests are refused. 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 Tree or flat view of your library. Click a file to see every hardlink sibling and which tracker is seeding it.	Torrents Every file qBittorrent / qui is seeding, with tracker, status, and reverse hardlink lookup.
Trackers Configurable chart of per-tracker analytics. Deep-link into the explorer pre-filtered by tracker.	Change log File-level diff between every consecutive audit, kept indefinitely.

---

Workflows

The dashboard tells you what's wrong; workflows fix it.

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