# 🔁 Recovarr
**Re-trigger Sonarr and Radarr imports for corrupted or missing media — with a live log and auto-unmonitor.**
[](LICENSE)
[](https://nodejs.org/)
[](#install)
---
Recovarr is a minimal Node.js web UI that queues corrupted or missing file paths for recovery, streams the live recovery log to your browser, polls Sonarr or Radarr until the import completes, and then automatically unmonitors the episode or movie so your curation stays clean.
No npm packages. No config files to edit by hand. Just Node.js, Bash, curl, and jq.
---
## What happens when you recover a file
1. Identify the media in Sonarr (TV) or Radarr (Movies) via the parse API
2. Check the download queue for a pending import
3. Check download history to see if the original torrent is still seeding
4. **If still available:** delete the file record and trigger an import scan
5. **If not available:** delete the file record and trigger an automatic search
6. Poll every 30 seconds until the download lands
7. Auto-unmonitor the episode or movie once the import confirms
---
## Quick start
```bash
git clone https://git.opensourcesolarpunk.com/Circuit-Forge/recovarr
cd recovarr
# Set up your API keys
mkdir -p ~/.config/media-postprocessor
cat > ~/.config/media-postprocessor/api-keys.conf <