Welcome to Huntarr.io
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, any future donation to my daughter's college fund would make her day! 100% of donations go toward her education. Regardless, enjoy Huntarr and please join us on Discord and Reddit for community support. Donate
Huntarr Documentation
The all-in-one companion for your *arr media stack. Automatically hunt missing media, upgrade quality, manage requests, and keep your library perfect.
What is Huntarr?
Huntarr runs alongside your existing Sonarr, Radarr, Lidarr, Readarr, Whisparr, and Prowlarr instances. It continuously searches for missing media, upgrades existing files to better quality, and manages swap-outs via Swaparr — all automatically and on a schedule you control.
Beyond the *arr apps, Huntarr also includes Movie Hunt (a standalone movie grabber with its own indexers and download clients), NZB Hunt (Usenet search), and Requests (a media request system for the person running Huntarr — not for other users).
Key Features
Automated Hunting
Continuously searches for missing TV shows, movies, music, books, and more across all your *arr instances.
Quality Upgrades
Automatically upgrades existing media to higher quality when better releases become available.
Smart Scheduling
Per-app, per-instance schedules with configurable cycles, intervals, and caps so you never overload your indexers.
Notifications
Discord, Telegram, Pushover, Email, Apprise, and more. Know the moment Huntarr finds or grabs something.
Movie Hunt
A full standalone movie grabber with indexer support, download client integration, and custom format scoring.
Swaparr Integration
Automatically manage stalled or slow downloads by swapping them for better alternatives.
Requests
Discover and request movies and shows for your library — for the person running Huntarr, not for other users.
Secure & Self-Hosted
Runs on your own hardware. Authentication, 2FA, and Plex SSO keep your setup safe.
Quick Links
Installation
Docker, Unraid, or run from source — get up and running in minutes.
Connect Your Apps
Add your Sonarr, Radarr, and other *arr instances to Huntarr.
Scheduling
Configure when and how often Huntarr hunts for your media.
FAQ & Troubleshooting
Common questions, issues, and solutions.
Supported Apps
| App | Missing | Upgrade | Notes |
|---|---|---|---|
| Sonarr | Yes | Yes | TV series — episodes and seasons |
| Radarr | Yes | Yes | Movies |
| Lidarr | Yes | Yes | Music — albums and tracks |
| Readarr | Yes | Yes | Books and audiobooks |
| Whisparr | Yes | Yes | Adult content |
| Prowlarr | — | — | Indexer management (sync with Huntarr) |
| Swaparr | — | — | Stalled download management |