This is an automated archive made by the Lemmit Bot.
The original was posted on /r/selfhosted by /u/User9705 on 2025-04-08 16:51:23+00:00.
Hey r/selfhosted community!
I wanted to share a tool I created that has completely changed how I manage my Sonarr library, and might solve some frustrations you've experienced too.
GITHUB:
The Problem Huntarr Solves
Have you ever:
- Added a bunch of shows only to find Sonarr leaving many episodes "missing"?
- Upgraded your quality standards and now have hundreds of episodes below cutoff?
- Wanted a way to gradually improve your library without babysitting Sonarr?
- Hit indexer rate limits when manually triggering too many searches?
Sonarr is excellent at managing your library, but it lacks a built-in way to continuously hunt for missing episodes or quality upgrades without manual intervention. That's where Huntarr comes in.
What Huntarr-Sonarr Does
Huntarr is a companion app that works alongside Sonarr to:
- Find Missing Episodes: Automatically identifies and searches for episodes marked as "missing"
- Upgrade Quality: Hunts for better versions of episodes below your quality cutoff
- Respect Rate Limits: Uses configurable delays between searches to prevent overloading indexers
- Distribute Searches: Randomly selects different shows and episodes each cycle to ensure everything gets attention
Web Interface with Real-Time Logs
Huntarr includes a clean web interface that lets you monitor activity and adjust settings on the fly:
Configure all options directly from the browser, no restart required:
Key Features
- ๐ Continuous Operation: Runs indefinitely until manually stopped
- ๐ฏ Dual Targeting: Processes both missing episodes and quality upgrades
- ๐ฒ Random Selection: Distributes searches across your library (or sequential if preferred)
- โฑ๏ธ Throttled Searches: Configurable delays to respect indexer limits
- ๐ Web UI: Real-time log viewer with day/night mode and settings management
- ๐พ Persistent Storage: All settings and state are saved and persist across container restarts
- ๐ฎ Future Episode Skipping: Skip searching for episodes that haven't aired yet
- ๐ฟ Reduced Disk Activity: Optional setting to skip series refresh operations
How It Works Behind the Scenes
Huntarr runs in cycles:
- Find Missing: Identifies shows with missing episodes and triggers searches for a configurable number
- Upgrade Quality: Finds episodes below cutoff and searches for better versions
- Track Progress: Remembers which shows/episodes it has processed to avoid repetition
- Reset & Repeat: After a configurable period, it resets its tracking and starts fresh
The "set and forget" design means you can leave it running in the background, and it will steadily improve your library over time without manual intervention.
Related Tools
I've also created Huntarr editions for other *arr apps:
- Huntarr for Radarr - For movies
- Huntarr for Lidarr - For music
- Huntarr for Readarr - For books
Links & Resources
Happy to answer any questions in the comments!