| Application | Status |
|---|---|
| Sonarr | ✅ Ready |
| Radarr | ✅ Ready |
| Lidarr | ✅ Ready |
| Readarr | ✅ Ready |
| Whisparr v2 | ✅ Ready |
| Whisparr v3 | ✅ Ready |
| Bazarr | ❌ Not Ready |
Keep in mind this is very early in program development. If you have a very special hand picked collection (because some users are extra special), test before you deploy.
- Overview
- Other Projects
- Community
- Indexers Approving of Huntarr
- Installation Methods
- How It Works
- Web Interface
- Tips
- Troubleshooting
- Change Log
This application continually searches your media libraries for missing content and items that need quality upgrades. It automatically triggers searches for both missing items and those below your quality cutoff. It's designed to run continuously while being gentle on your indexers, helping you gradually complete your media collection with the best available quality.
For detailed documentation, please visit our Wiki.
- Unraid Intel ARC Deployment - Convert videos to AV1 Format (I've saved 325TB encoding to AV1)
- Visit PlexGuide for more great scripts
Join the community on Discord!
My 12-year-old daughter is passionate about singing, dancing, and exploring STEM. She consistently earns A-B honors! Every donation goes directly into her college fund!
The most common and recommended way to install Huntarr.
Huntarr now offers native macOS support!
You can install Huntarr through the Unraid App Store or via command line.
🔌 Huntarr connects to your Sonarr/Radarr/Lidarr/Readarr/Whisparr/Eros instances and analyzes your media libraries to identify both missing content and potential quality upgrades.
- 🔍 Efficient Refreshing: Skip metadata refresh to reduce disk I/O and database load
- 🔮 Future-Aware: Automatically skip content with future release dates
- 🎯 Precise Control: Configure exactly how many items to process per cycle
- 👀 Monitored Only: Focus only on content you've marked as monitored
- ⬆️ Quality Improvement: Find content below your quality cutoff settings
- 📦 Batch Processing: Set specific numbers of upgrades to process per cycle
- 🚦 Queue Management: Automatically pauses when download queue exceeds your threshold
- ⏱️ Command Monitoring: Waits for commands to complete with consistent timeouts
- 🛡️ Rate Protection: Hourly caps prevent overloading your indexers
- ⏲️ Universal Timeouts: Consistent API timeouts (120s) across all applications
- 🔄 Consistent Headers: Identifies as Huntarr to all Arr applications
- 📊 Intelligent Monitoring: Visual indicators show API usage limits
💤 Huntarr waits for your configured interval (adjustable in settings) before starting the next cycle, ensuring your indexers aren't overloaded while maintaining continuous improvement of your library.
Huntarr's live homepage will provide you statics about how many hunts have been pursed regarding missing media and upgrade searches! Note: Numbers reflected are but all required for testing.
Homepage
Huntarr includes a real-time log viewer and settings management web interface that allows you to monitor and configure its operation directly from your browser.
Logger UI
The web interface is available on port 9705. Simply navigate to:
http://YOUR_SERVER_IP:9705
The URL will be displayed in the logs when Huntarr starts, using the same hostname you configured for your API_URL.
The web interface allows you to configure all of Huntarr's settings:
Settings UI
To ensure data persistence, make sure you map the /config directory to a persistent volume on your host system:
-v /your-path/appdata/huntarr:/config
+
Huntarr is the compulsive librarian who finds missing media and upgrades your existing content. It fills in the blanks and improves what you already have.
Cleanuperr (
When combined, these tools create a powerful, self-sufficient media automation stack:
- Huntarr hunts for content to add to your library
- Cleanuperr ensures only clean downloads get through
- Together, they create a reliable, hands-off media management system
Learn more about Cleanuperr at https://github.com/flmorg/cleanuperr
- First-Time Setup: Navigate to the web interface after installation to create your admin account with 2FA option
- API Connections: Configure connections to your *Arr applications through the dedicated settings pages
- Search Frequency: Adjust Sleep Duration (default: 900 seconds) based on your indexer's rate limits
- Batch Processing: Set Hunt Missing and Upgrade values to control how many items are processed per cycle
- Queue Management: Use Minimum Download Queue Size to pause searching when downloads are backed up
- Skip Processing: Enable Skip Series/Movie/Artist Refresh to significantly reduce disk I/O and database load
- Future Content: Keep Skip Future Items enabled to avoid searching for unreleased content
- Authentication: Enable two-factor authentication for additional security on your Huntarr instance
- API Rate Limits: Configure hourly API caps to prevent rate limiting by your indexers
- Universal Timeouts: All apps use consistent 120s timeouts for reliable command completion
- Monitored Only: Filter searches to focus only on content you've marked as monitored
- Notifications: Configure Apprise notifications to get alerts when media is processed
- API Connection Issues: Verify your API key and URL in the Settings page (check for missing http:// or https://)
- Config URLs: It is best practice to omit the trailing slash (/) at the end of the URL for each service. For Sonarr, use http://10.10.10.1:8989 instead of http://10.10.10.1:8989/
- Authentication Problems: If you forget your password, delete
/config/user/credentials.jsonand restart - Two-Factor Authentication: If locked out of 2FA, remove credentials file to reset your account
- Web Interface Not Loading: Confirm port 9705 is correctly mapped and not blocked by firewalls
- Logs Not Showing: Check permissions on the
/config/logs/directory inside your container - Missing State Data: State files in
/config/stateful/track processed items; verify permissions - Docker Volume Issues: Ensure your volume mount for
/confighas correct permissions and ownership - Command Timeouts: Default values are now command_wait_delay=1s and command_wait_attempts=600
- Debug Information: Enable Debug Mode temporarily to see detailed API responses in the logs
- API Timeout Errors: All apps now use universal timeout settings (120s) from general.json
- Consistent Log Filtering: If app-specific logs show mixed content, reduce historical data from 5KB to 1KB
- Swaparr Issues: Ensure proper handling of non-dictionary records in queue data
- App-Specific Problems: Check GitHub Issues for known problems and solutions
![@github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=64&v=4){kind=small}
