Welcome to Huntarr
A Message from Admin9705
Huntarr started as a simple bash script to solve a real problem: *arr apps don't actively search for missing content in your existing library. What you see today evolved from that need, with input from users who discovered they had significant gaps they didn't even know existed. The best validation? My wife finally cancelled our streaming subscriptions because our setup actually works.
If you love the program, future donations to my daughter's 529 college fund make her day! I never profit from this, and actually put a lot into supporting this. Regardless, enjoy Huntarr and also check out HuntarrOS.com for cool Docker deployment orchestration.
Huntarr Documentation
The all-in-one media automation platform. Hunt missing content, upgrade quality, manage requests, and run your entire media library — automatically.
What is Huntarr?
Your *arr apps (Sonarr, Radarr, etc.) monitor RSS feeds for new releases — but they don't go back and actively search for content already missing from your library. Over time, gaps build up: missing seasons, movies stuck below your quality cutoff, albums with incomplete tracks. Nobody fixes this automatically.
Huntarr does. It systematically scans your entire library, identifies all missing or below-cutoff content, and searches your indexers in small, safe batches. It pauses when your download queues are full, respects per-instance API caps, and starts again automatically. Completely hands-off.
But Huntarr has grown well beyond a missing-content hunter. It now includes its own built-in Movie Hunt and TV Hunt modules (standalone alternatives to Radarr and Sonarr), Index Master (a Prowlarr alternative built right in), NZB Hunt (a fully self-contained Usenet download client), and Requestarr (a complete user request and approval system). Use all of them, some of them, or none — your existing *arr stack always works alongside whatever you choose.
New to Huntarr? Start Here
If you're installing Huntarr for the first time, follow these steps in order. Most users are up and running in under 10 minutes.
1. Install Huntarr
Run Huntarr via Docker (recommended), Unraid Community Apps, or as a standalone process on any Linux/macOS/Windows machine. See the Installation Guide.
2. Complete Setup Wizard
Create your admin account, optionally enable 2FA, and link your Plex account for easy user sign-in. The wizard walks you through it. See Setup Wizard.
3. Connect Your *arr Apps
Go to Apps and add your Sonarr, Radarr, Lidarr, Readarr, or Whisparr instances. Enter the URL and API key — Huntarr will start hunting immediately.
4. Customize Schedules
Visit Settings → Scheduling to configure how often Huntarr searches for missing and below-cutoff content. Start with defaults — they work well for most users.
How It Works
Understanding Huntarr's core concept helps you get the most out of it:
Your *arr apps (Sonarr, Radarr, etc.) are great at grabbing new releases from RSS. But they don't go back and search for content that was already missing when you added it, or content sitting below your quality cutoff. Over time, your library develops hundreds of invisible gaps.
Huntarr solves this. It works alongside your existing *arr apps — it reads their libraries, finds every missing episode, movie, album, or book, and triggers searches in small, safe batches. It respects rate limits, pauses when your download queue is busy, and runs 24/7 on configurable schedules.
On top of that, Huntarr includes powerful built-in modules like Movie Hunt (a standalone Radarr alternative), NZB Hunt (a built-in Usenet client), and Requestarr (a full media request system for your family and friends). Each module is optional — enable what you need.
Pro Tips for New Users
Huntarr ships with sensible defaults. Let it run for 24 hours before tweaking schedules — you'll be surprised how much it finds on its own.
Setting very short intervals (e.g., every 1 minute) will get your indexer accounts rate-limited or banned. The default 15–30 minute cycles are designed to be safe.
Enable Requestarr and let family members request movies and TV shows through a simple web UI. You can approve or auto-approve requests, and it broadcasts to all your connected instances at once.
Key Features
Automated Hunting
Continuously scans for missing TV shows, movies, music, books, and adult content across all your *arr instances — simultaneously, on independent schedules.
Quality Upgrades
Automatically finds media below your quality cutoff and triggers upgrade searches. 720p in your library? Huntarr hunts for 1080p without you lifting a finger.
Smart Scheduling
Per-app, per-instance schedules with configurable intervals and hourly search caps. Never overload your indexers or get rate-limited again.
Notifications
Discord, Telegram, Pushover, Email, Apprise, and more. Get notified the moment Huntarr finds something, grabs something, or hits an error.
Movie Hunt & TV Hunt
Full standalone movie and TV management with discovery UI, quality profiles, root folder management, and direct disk import. No Radarr or Sonarr required.
NZB Hunt
A complete Usenet client built right in. Connect NNTP servers, download NZBs, direct-unpack RARs, and manage your full queue — without SABnzbd or NZBGet.
Requestarr
Full media request system with user accounts, approval queues, per-user permissions, auto-approve, and bundles that broadcast a single request to multiple instances simultaneously.
Secure & Self-Hosted
Runs entirely on your own hardware. Local auth with bcrypt, optional 2FA with TOTP, and Plex SSO sign-in for user-friendly access to Requestarr.
Quick Links
Installation
Docker, Unraid, Windows, macOS, or Linux — get up and running in minutes.
Connect Your Apps
Add your Sonarr, Radarr, Lidarr, Readarr, and Whisparr instances to start hunting.
Scheduling
Configure hunt intervals, search caps, and upgrade cycles per app and instance.
FAQ & Troubleshooting
Common questions, known issues, and step-by-step solutions.
Supported Third-Party Apps
Huntarr connects to all major *arr apps and works alongside them. Add multiple instances of each — for example, a 1080p Sonarr and a 4K Sonarr — and Huntarr hunts across all of them independently.
| App | Missing Hunt | Quality Upgrade | Notes |
|---|---|---|---|
| Sonarr | ✅ Yes | ✅ Yes | TV series — episodes and full seasons |
| Radarr | ✅ Yes | ✅ Yes | Movies — any monitored film |
| Lidarr | ✅ Yes | ✅ Yes | Music — albums, tracks, and artists |
| Readarr | ✅ Yes | ✅ Yes | Books and audiobooks |
| Whisparr v2 | ✅ Yes | ✅ Yes | Adult content (v2 API) |
| Whisparr v3 | ✅ Yes | ✅ Yes | Adult content (v3 API) |
| Prowlarr | — | — | Indexer management (sync with Huntarr) |
| Swaparr | — | — | Stalled download management integration |
Built-in Modules
These modules are built directly into Huntarr. They can replace or run alongside their *arr equivalents.
| Module | Replaces | Status | Description |
|---|---|---|---|
| Movie Hunt | Radarr | Beta | Full movie management with discovery, quality profiles, and library tracking |
| TV Hunt | Sonarr | Beta | Full TV/series management with episode and season tracking |
| Index Master | Prowlarr | Beta | Manage Usenet and torrent indexers directly inside Huntarr |
| NZB Hunt | SABnzbd / NZBGet | Beta | Full Usenet download client with multi-server, queue, and direct unpack |
| Requestarr | Overseerr / Jellyseerr | Stable | User request system with approval queue, bundles, and permissions |