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:

Identifies the media in Sonarr (TV) or Radarr (Movies) via the parse API
Checks the download queue for a pending import
Checks download history to see if the original torrent is still available
If available: deletes the file record and triggers an import scan
If not available: deletes the file record and triggers an automatic search
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

2.5 KiB Raw Blame History