Radarr Documentation
Radarr is an automated movie downloading and management application. Huntarr integrates with your existing Radarr instance to automatically search for missing movies and quality upgrades that Radarr doesn't actively hunt for.
Radarr Instance Setup
Adding Your Radarr Instance
To connect your existing Radarr instance to Huntarr:
- Navigate to the Radarr section in Huntarr
- Click "Add Radarr Instance" if you don't have one configured
- Fill in your Radarr connection details
- Test the connection to ensure Huntarr can communicate with Radarr
Connection Settings
Configure these settings to connect Huntarr to your Radarr instance:
| Setting | Description | Example | Notes |
|---|---|---|---|
| Name | Friendly name for this Radarr instance | Default, Movies-4K, Foreign | Useful when running multiple Radarr instances |
| URL | Base URL for your Radarr instance | http://10.0.0.10:7878 | Include protocol (http/https) and port |
| API Key | Radarr API key for authentication | b04d87c7392d5ce4f9a6b85f6c8e470 | Found in Radarr Settings > General > Security |
| Enabled | Whether Huntarr should process this instance | On/Off toggle | Disable to temporarily stop processing |
Search Settings
Configure how Huntarr searches for missing movies and upgrades in your Radarr instance. These settings control Huntarr's behavior when processing your movie library.
Missing Search Mode
Determines how Huntarr searches for missing movies:
- Movies: Standard mode that searches for individual movies. Recommended for most users
- Collections: Searches for movie collections when available. Useful for franchise collections
Upgrade Mode
Controls how Huntarr handles quality upgrades:
- Movies: Upgrades individual movies when better quality becomes available
- Collections: Upgrades entire movie collections at once when better quality is found
Search Limits
Control how many items Huntarr processes per cycle to avoid overwhelming your indexers:
| Setting | Description | Recommended | Notes |
|---|---|---|---|
| Missing Search | Number of missing movies to search per cycle | 3-5 | Set to 0 to disable missing searches |
| Upgrade Search | Number of movies to upgrade per cycle | 1-2 | Set to 0 to disable upgrade searches |
| Sleep Duration | Time in seconds between processing cycles | 1200 (20 min) | Longer intervals reduce indexer load |
| API Cap - Hourly | Maximum API requests per hour | 300 or less | Prevents rate limiting from indexers |
Additional Options
Fine-tune Huntarr's behavior with these additional settings:
Monitored Only
When enabled, Huntarr will only search for movies that are marked as "Monitored" in Radarr. This prevents searches for movies you've intentionally unmonitored.
Skip Future Movies
When enabled, Huntarr will skip movies with future release dates. This prevents unnecessary searches for content that hasn't been released yet.
Minimum Availability
Respects Radarr's minimum availability setting. Huntarr will only search for movies that meet your configured availability requirements (Announced, In Cinemas, Released, etc.).
Troubleshooting
Common Issues
Connection Failed
If Huntarr can't connect to your Radarr instance:
- Verify the URL is correct and includes the protocol (http/https)
- Check that the port number is correct (default: 7878)
- Ensure the API key is copied correctly from Radarr Settings > General > Security
- Confirm Radarr is running and accessible from Huntarr's network
- Check firewall settings if Huntarr and Radarr are on different machines
No Missing Movies Found
If Huntarr reports no missing movies but you know there are gaps:
- Ensure "Monitored Only" is configured correctly for your needs
- Check that movies are marked as "Monitored" in Radarr
- Verify "Skip Future Movies" isn't preventing searches for available content
- Review your minimum availability settings in both Radarr and Huntarr
Large File Downloads
If movie downloads are overwhelming your system:
- Reduce the "Missing Search" and "Upgrade Search" limits
- Increase the "Sleep Duration" between processing cycles
- Consider setting up separate Radarr instances for different quality profiles
- Monitor your download client's queue and disk space
Quality Profile Issues
If Huntarr isn't finding the right quality:
- Verify your quality profiles are properly configured in Radarr
- Check that your indexers support the quality levels you're seeking
- Review cutoff settings to ensure upgrades are allowed
- Consider adjusting your upgrade search frequency