Recovarr

Web UI for re-triggering Sonarr/Radarr imports on corrupted or missing media files.

Recovarr queues file paths for recovarr.sh, streams live script output via Server-Sent Events (SSE), polls Sonarr/Radarr for import completion, and auto-unmonitors episodes/movies once the download lands.

---

What it does

Given a path to a corrupted or missing media file, Recovarr:

1. Identifies the media in Sonarr (TV) or Radarr (Movies) via the parse API
2. Checks the download queue for a pending import
3. Checks download history to see if the original torrent is still available
4. If available: deletes the file record and triggers an import scan
5. If not available: deletes the file record and triggers an automatic search
6. Polls every 30s until the import completes, then auto-unmonitors

---

Requirements

• Node.js 18+
• Bash 4+, curl, jq (for recovarr.sh)
• No npm dependencies — pure Node.js built-ins only

---

Install

git clone https://git.opensourcesolarpunk.com/Circuit-Forge/recovarr
cd recovarr

Config

mkdir -p ~/.config/media-postprocessor
cat > ~/.config/media-postprocessor/api-keys.conf <<EOF
SONARR_URL=http://your-sonarr-host:8989/sonarr
SONARR_API_KEY=your-sonarr-api-key
RADARR_URL=http://your-radarr-host:7878/radarr
RADARR_API_KEY=your-radarr-api-key
QBIT_USER=admin
QBIT_PASS=adminadmin
EOF

---

Run

node server.js
# or with overrides:
PORT=8602 ARR_RECOVER_SCRIPT=/path/to/recovarr.sh node server.js

Open http://localhost:8602 in your browser. Paste one or more file paths and click Recover.

---

Environment variables

Variable	Default	Description
PORT	8602	Web UI port
ARR_RECOVER_CONFIG	~/.config/media-postprocessor/api-keys.conf	Config file path
ARR_RECOVER_SCRIPT	./recovarr.sh	Path to the recovarr.sh script
ARR_RECOVER_LOG	~/.local/share/recovarr/jobs.log	Job log path
ARR_RECOVER_QUEUE	~/.local/share/recovarr/pending-queue.json	Pending queue path

---

API

Method	Path	Description
POST	/api/recover	Queue file paths { paths: ["/path/to/file"] }
GET	/api/jobs	List all jobs
GET	/api/jobs/:id	Get job detail + log lines
GET	/api/jobs/:id/stream	SSE stream of live log output
POST	/api/jobs/:id/retry	Retry a failed job
DELETE	/api/jobs/:id	Delete a job (?force=true to cancel active)

---

License

GPL-3.0