New Grimoire

Shadow-Grimoire/Overview.md

@@ -0,0 +1,83 @@
+---
+title: Shadow Grimoire
+description: Acquisition stack — the goblin hacker sails the high seas
+published: true
+date: 2026-04-12T00:00:00.000Z
+tags: shadow, acquisition, arr
+editor: markdown
+dateCreated: 2026-04-12T00:00:00.000Z
+---
+
+# Shadow Grimoire
+
+![shadow-badge](/images/shadow-badge.png)
+
+The Shadow Grimoire is the acquisition and media management infrastructure. Usenet + torrents, protected behind `*.wasted-bandwidth.net` and Authelia. Homepage tab: **Wasted-Bandwidth**.
+
+The goblin hacker doesn't ask permission.
+
+---
+
+## Services by Group
+
+### Jolly Roger — Indexers
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| NZBHydra | `hydra.netgrimoire.com` | Usenet indexer aggregator (altHUB, NZBGeek, Drunken Slug, Usenet Crawler, DogNZB) |
+| Jackett | `jackett.netgrimoire.com` | Torrent indexer — runs inside Gluetun VPN on docker2 |
+
+### Downloaders
+
+| Service | URL | Purpose | Host |
+|---------|-----|---------|------|
+| SABnzbd | — | Usenet downloader | znas / Swarm |
+| NZBGet | — | Usenet downloader | znas / Swarm |
+| Transmission | — | BitTorrent client | docker2 (via Gluetun VPN) |
+| Gluetun | — | VPN gateway — PIA VPN | docker2 / Compose |
+
+Jackett and Transmission share `network_mode: container:gluetun` — all their traffic routes through the PIA VPN.
+
+### Arr Stack — Media Management
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| Sonarr | — | TV show acquisition |
+| Radarr | — | Movie acquisition |
+| Bazarr | `bazarr.netgrimoire.com` | Subtitle management |
+| Readarr | — | Book acquisition |
+| Lidarr | — | Music acquisition |
+| Beets | `beets.netgrimoire.com` | Music library tagging |
+| Mylar | — | Comic acquisition (📋 planned — see `archive/arr.yaml`) |
+
+### Config Management
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| Recyclarr | — | Sonarr/Radarr quality profile sync |
+| Profilarr | `profilarr.netgrimoire.com` | Quality profile management |
+| Configarr | `configarr.netgrimoire.com` | Arr config management |
+
+### Media Search & Discovery
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| JellySeerr | `requests.netgrimoire.com` | Media request management |
+| TinyMediaManager | `tmm.netgrimoire.com` | Media metadata manager |
+| Pinchflat | `pinchflat.netgrimoire.com` | YouTube channel downloader |
+| Tunarr | — | IPTV channel creation (ErsatzTV replacement) |
+
+---
+
+## Network Notes
+
+Jackett and Transmission run on docker2 via Docker Compose, not Swarm. They use `network_mode: container:gluetun` to route through the PIA VPN. Caddy reaches Jackett via the `netgrimoire` overlay using an internal hostname.
+
+---
+
+## Pending
+
+- [ ] Prowlarr — low priority (NZBHydra covers current needs)
+- [ ] Mylar — comic downloader, needs setup (reference `archive/arr.yaml`)
+- [ ] Soularr — Soulseek integration for Lidarr
+- [ ] MeTube — YouTube downloader for Tunarr filler workflow