Huntarr is a companion automation service for the *arr ecosystem that continuously scans your libraries for missing content and items below your quality cutoff. It then triggers searches in small, controlled batches to gradually complete and upgrade your collection while staying gentle on indexers.

Key Features

Integrates with Sonarr, Radarr, Lidarr, Readarr, and Whisparr to analyze monitored libraries
Automatically hunts missing items, skipping unreleased content and reducing load by avoiding unnecessary metadata refresh
Quality-upgrade hunting for items below your configured cutoff, with configurable batch sizes per cycle
Download-queue aware behavior (can pause actions when the queue exceeds a threshold)
Built-in indexer-friendly API management, including hourly caps and consistent timeouts
Continuous run loop with configurable intervals between cycles

Use Cases

Keep a “mostly complete” library progressing toward complete coverage without manual searches
Automatically push upgrades (better quality releases) for existing items over time
Run a hands-off media automation workflow alongside existing *arr applications

Limitations and Considerations

Requires existing, correctly configured *arr applications and indexers; Huntarr triggers searches but does not replace the *arr stack
Effectiveness depends on indexer availability, rate limits, and your monitoring/quality settings

Huntarr fits best as a lightweight, always-on background utility for media automation setups that want continuous completion and quality improvement. With conservative batching and rate controls, it aims to enhance automation without overwhelming your services.