Media rules — never ignore these
Standing rules for the media stack (seedboxes, LincStation, Plex/*arr, emulation). Agreed with Marita 2026-07-30. These are not suggestions; treat a conflict with them as a bug.
Related: MEDIA.md · LEARNINGS.md · Z:\Knowledge\HQ\PLATFORM-V2\domains\MEDIA-SESSION-HANDOVER.md
1. Quality: take it now, upgrade it later
- For a new release Marita actually wants, grab the best available even if it is CAM or TELESYNC. Do not make her wait for a WEB-DL.
- Every low-quality grab is queued for upgrade at the same moment it is taken. Category
tl-upgrade-me, and the Radarr/Sonarr entry set monitored, on the HD-1080p profile with upgrades allowed. - When a 1080p (or better) release appears, it replaces the low-quality copy automatically and the old file is removed only after the new one has imported successfully.
- Prefer, in order: BluRay/REMUX > WEB-DL > WEBRip > CAM/TS. Never take a CAM for something that already exists as WEB-DL.
- Watch out: a search for a film often returns a making-of documentary or a same-titled
different film. Match on title AND year, and exclude
Making of|Behind the Scenes|Featurette.
2. Deleting: completeness first, always
Never delete anything from either seedbox until it is fully mirrored to the LincStation.
- The gate is bytes, not folder names. The mirror creates its destination folder the instant it
starts, so a 890 GB collection that is 4% copied looks mirrored by name.
Require local size ≥ 99.5% of torrent size, measured with
du -sb. (This rule exists because a name-only check once offered up 931 GB that was still copying.) - If completeness cannot be verified, nothing is releasable. Never guess toward deleting.
- Applies to both seedboxes, equally.
- qBittorrent's
deleteFiles=truelies — it returns HTTP 200 and sometimes deletes nothing. Always verify on disk afterwards and remove leftovers explicitly. - Never bulk-delete on a fuzzy name match. Explicit hashes only, and check every response.
3. Seeding: keep one earner, move the rest
Once a torrent meets the criteria in rule 2:
- Choose exactly one torrent to leave seeding — the one most likely to actually earn ratio.
Pick on recency and demand, not size: a 2025/2026 release with active peers earns; a
decade-old ROM pack sits at
stalledUPforever. Evidence: of 3.5 TB across 9 collections, one 2025 arcade pack produced 91.7 of the 92.0 GiB ever uploaded. The other eight earned nothing. - Everything else moves to the LincStation and is released from the seedbox.
- Marita is VIP on TorrentLeech → exempt from hit-and-run and ratio rules. The tracker is therefore never the blocker; completeness (rule 2) is.
- Re-downloading is not free. Deleting and re-grabbing non-freeleech data adds it to her download stat. Re-downloading ~2.7 TB would take site ratio 0.822 → 0.138. So: never re-download to move data. Transfer it. Direct downloading is only for content that has not been downloaded yet.
- Freeleech grabs do not count against site ratio — prefer them, and check
indexerFlags.
4. Mirroring: windowed, and off the contended spindle
- Large transfers (>100 GB) run only between 01:00 and 09:00 America/Mexico_City, unattended.
- Never run a large mirror while she is gaming or watching. The LincStation has one array spindle serving everything; a concurrent rclone job took reads from 152 MB/s down to 4.5 MB/s with 3.5-second stalls.
- Do not throttle with
--bwlimitas a fix. It stretches the contention window instead of removing it (6 days of interference becomes ~32). Run flat-out inside the window, or not at all. - Write to the NVMe cache, not through shfs to the array, and let the mover drain it.
- Before a gaming session: stop the rclone container and
touch /tmp/seedbox-sync.lockso the flocked cron skips. Remove the lock afterwards. Measured effect: load average 22.6 → 0.33, ROM reads 246 MB/s, GameCube ISO 154 MB/s.
5. Library completeness before novelty
- Finish every outstanding Overseerr request before adding new wants. The goal is a library that already contains what the household asks for, after which new titles trickle in.
- Requests come from Marita and her girlfriend — treat both as first-class. Open example: "Las Azules" — the English release name is Women in Blue (2024). Search the English title; the Spanish one returns almost nothing.
- Sonarr's
wanted/missingonly returns aired episodes. Derive "not yet aired" separately or the counts will lie. - Page through the API. A single call truncates at
pageSize— this once reported 2,000 missing episodes when the real number was 9,149.
6. The local client must never sit idle
- A health checker runs continuously against the LincStation's qBittorrent and alerts when:
- anything is
stalledDL/queuedDLwith zero active downloads, - total download speed is 0 while incomplete torrents exist,
- gluetun is unhealthy or the forwarded port has changed,
- the queue limit is starving everything (the usual cause).
- anything is
- Alerts go to the one Telegram path (
nas-watchdog.sh), on state change only — never spam. - Seen 2026-07-30: 186 incomplete torrents, 2,785 GiB outstanding, 134 queued + 48 stalled, and zero actually downloading. That must page us, not sit silently.
7. Discovery: bring TL to the dashboard, by category
- Pull new releases from TorrentLeech and surface them in the Media Ops dashboard, split by category, each with a one-click download. Source: https://www.torrentleech.org/torrents/movies (and the TV equivalent).
- Show quality (4K / 1080p / 720p / CAM-TS), size, seeders, age, and freeleech.
- Downloads triggered from the dashboard go to the local client — full speed, no seedbox space, no ratio cost.
- Never surface a bare port link. Everything lives behind a tile in the HQ app.
8. Non-negotiables carried over
- Files live on the LincStation. The gaming desktop runs compute, never the library.
- Credentials stay server-side (nginx proxy routes), never in the browser.
- Personal media stays separate from client infrastructure.
- Report what actually happened. A tool returning success is not evidence; verify.
Operating notes that keep biting
| Trap | Rule |
|---|---|
crontab <file> on Unraid |
Never. It is not additive and orphans a second crontab that fires every job twice. Edit /boot/config/plugins/dynamix/*.cron then update_cron. |
| bash heredoc writing a script | Eats one backslash — \\server becomes \server. Use the Write tool for anything containing UNC paths. |
powershell -Command - on stdin |
Executes line by line; multi-line blocks break. Use -EncodedCommand or push a file with scp -O. |
scp to the gaming desktop |
Plain scp fails; use scp -O. |
Importing a module that wraps sys.stdout |
Closes the importer's buffer. Keep shared constants in a module that touches nothing. |
Prowlarr downloadUrl |
Points at 127.0.0.1:9696. Rewrite the host before fetching. |
| Seedbox 1 | SFTP only — no shell. Use its HTTPS API. |