mirror of https://github.com/nickyeoman/docker-compose-cookbooks.git synced 2026-09-04 02:46:23 +00:00

Files

T

nick 1d0ee19a68 feat: add readarr, whisparr, and bazarr stacks

- Add readarr_dev (eBook/audiobook collection manager, port 8787)
- Add whisparr_dev (adult content manager, port 6969)
- Add bazarr_dev (subtitle management companion, port 6767)
- Bazarr uses a shared /media volume for writing subtitles
- All stacks follow template conventions (defaults, proxy network,
  VOL_PATH=/data, README section order)

2026-07-02 21:37:11 -07:00

compose.yaml

feat: add readarr, whisparr, and bazarr stacks

2026-07-02 21:37:11 -07:00

README.md

feat: add readarr, whisparr, and bazarr stacks

2026-07-02 21:37:11 -07:00

sample.env

feat: add readarr, whisparr, and bazarr stacks

2026-07-02 21:37:11 -07:00

README.md

Whisparr

Overview

Whisparr is an automated adult content collection manager for Usenet and BitTorrent users. It monitors your watchlist, scans configured indexers for releases, and sends matches to your download client. After download, it renames and organizes files into your media library and can notify your media server.

Project Details

Project Repository: https://whisparr.com/
Container Image: ghcr.io/hotio/whisparr
Reverse Proxy Port: 6969

Getting Started

Open http://localhost:6969 in your browser and complete the initial setup wizard:

Choose your UI language
Add a download client — select qBittorrent, enter its host/port/credentials
Add an indexer — or connect to Prowlarr for automatic indexer sync

Once the wizard finishes, you'll see an empty library. To populate it:

Go to Settings → Media Management and add a Root Folder (e.g., /adult) — this is where your organized library will live
Click Add Movie and search by title — Whisparr fetches metadata and available releases
Optionally connect a List to auto-import from your watchlists

Download flow

qBittorrent downloads to its own directory → Whisparr picks it up, renames the file, and moves it into <Root Folder>/Title (Year)/

Environment Variable Notes

Variable	Description
`WHISPARR_IMAGE`	Container image (default: `ghcr.io/hotio/whisparr:release`)
`WHISPARR_RESTART`	Restart policy (default: `unless-stopped`)
`WHISPARR_PORT`	Published port for the web UI (default: `6969`)
`VOL_PATH`	Base path for persistent data volumes (default: `/data`)
`TZ`	Container timezone (default: `America/Vancouver`)

Volume Notes

Volume	Purpose
`${VOL_PATH:-/data}/whisparr/config`	Application configuration and database
`${VOL_PATH:-/data}/whisparr/data`	Download client data and working directory

Network Notes

Requires an external proxy network. Create it once with:

docker network create proxy

Docker Run

docker run -d \
  --name=whisparr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=002 \
  -e TZ=America/Vancouver \
  -p 6969:6969 \
  -v ${VOL_PATH:-/data}/whisparr/config:/config \
  -v ${VOL_PATH:-/data}/whisparr/data:/data \
  --network proxy \
  --restart unless-stopped \
  ghcr.io/hotio/whisparr:release

Dockhand Stack, Deploy from Git

Cookbooks Repository
stackname: whisparr_dev
Compose file path: whisparr_dev/compose.yaml
Additional env file (optional): whisparr_dev/sample.env

Load whisparr_dev/sample.env into the Environment variables in Dockhand, then create the Stack.