Huntarr
A media automation platform that goes beyond the *arr ecosystem. Huntarr hunts for missing content and quality upgrades across your existing Sonarr, Radarr, Lidarr, Readarr, and Whisparr instances — while also providing its own built-in Movie Hunt, TV Hunt, Index Master, NZB Hunt, and Requestarr modules that can replace or complement your existing stack.
Stars help others discover Huntarr — if you find it useful, click the ⭐ in the upper-right corner!
PayPal Donations — Building My Daughter's Future
My 12-year-old daughter loves singing, dancing, and exploring STEM. She's an A-B honor roll student with big dreams for the future. Any donation you make will go directly toward her college fund, helping her turn those dreams into reality. Thank you for your support!
🚀 HuntarrOS is here. Rebuilt from the ground up for 2026 — a self-hosted server management platform running as a single Docker container. App store, Cloudflare Tunnels, Traefik, MergerFS drive pooling, backups, and more. One-line install on Ubuntu & Debian.
Table of Contents
- What Huntarr Does
- Third-Party *arr Support
- Movie Hunt & TV Hunt
- Index Master
- NZB Hunt
- Requestarr
- Add to Library
- How It Works
- Installation
- The Classic
- Other Projects
- Huntarr + Cleanuparr
- Contributors
- Change Log
- License
What Huntarr Does
Your *arr apps monitor RSS feeds for new releases, but they don't go back and search for missing episodes or movies already sitting in your library. Over time, gaps build up — missing seasons, unavailable albums, content stuck below your quality cutoff. Nobody goes back to fix it.
Huntarr does. It systematically scans your entire library, finds all missing content, and searches for it in small batches that won't overwhelm your indexers or get you banned. It also finds content below your quality cutoff and triggers upgrades automatically.
But Huntarr has grown well beyond a missing content hunter. It now includes its own built-in modules that can replace parts of your stack entirely:
| Module | What It Does |
|---|---|
| Movie Hunt | A built-in movie management system — browse, discover, and track movies without needing Radarr |
| TV Hunt | A built-in TV show management system — track series, seasons, and episodes without needing Sonarr |
| Index Master | Manage and search your indexers directly from Huntarr — a Prowlarr alternative built right in |
| NZB Hunt | A full Usenet download client — connect your NNTP servers and download NZBs without a separate app |
| Requestarr | Let users request movies and TV shows through an approval queue you control |
The key thing: third-party *arr support is always front and center. You can use Huntarr's built-in modules, your existing *arr apps, or both at the same time. Nothing is forced — you pick what works for your setup.
Third-Party *arr Support
Huntarr connects to your existing *arr stack and works alongside it. Configure multiple instances of each app and Huntarr will hunt across all of them.
| Sonarr | Radarr | Lidarr | Readarr | Whisparr v2 | Whisparr v3 |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
Movie Hunt & TV Hunt
Browse, discover, and manage your media collection with a visual interface. Movie Hunt and TV Hunt are built-in alternatives to Radarr and Sonarr — see what's in your library, what's missing, and what needs upgrading, all in one place.
Use them standalone or alongside your existing *arr apps. They share the same indexer and download client configuration through Index Master and NZB Hunt.
Index Master
Manage your indexers directly inside Huntarr. Add Usenet and torrent indexers, test connections, and search across all of them — no need for a separate Prowlarr instance. Index Master feeds into both the built-in Movie Hunt / TV Hunt modules and the third-party *arr hunting engine.
NZB Hunt
A full Usenet download client built into Huntarr. Connect your NNTP servers and download NZBs directly — no SABnzbd or NZBGet required. Supports multiple server connections with up to 120 threads, speed limiting, and a download queue you can manage from the web UI.
Requestarr
Let users request movies and TV shows through a clean request interface. Requests flow through an approval queue so you stay in control of what gets added to your library. Works with both the built-in Movie Hunt / TV Hunt and your external *arr instances.
Add to Library
Quickly add new movies and TV shows. Search by title, pick your quality profile, and send it straight to your library — whether that's through Movie Hunt, TV Hunt, Sonarr, or Radarr.
How It Works
- Connect — Point Huntarr at your Sonarr, Radarr, Lidarr, Readarr, or Whisparr instances (or use the built-in modules)
- Hunt Missing — Scans your library for missing content and searches in small, indexer-friendly batches
- Hunt Upgrades — Finds content below your quality cutoff and triggers upgrade searches
- API Management — Hourly caps prevent indexer overload; pauses when download queues are full
- Repeat — Waits for your configured interval, then runs again. Hands-off, continuous improvement
Installation
Docker (Recommended)
docker run -d \
--name huntarr \
--restart unless-stopped \
-p 9705:9705 \
-v /path/to/config:/config \
-v /path/to/media:/media # Optional — for Movie Hunt / TV Hunt library access
-v /path/to/downloads:/downloads # Optional — for NZB Hunt download output
-e TZ=America/New_York \
-e PUID=1000 \ # Optional — run as specific user ID
-e PGID=1000 \ # Optional — run as specific group ID
huntarr/huntarr:latest
Docker Compose
services:
huntarr:
image: huntarr/huntarr:latest
container_name: huntarr
restart: unless-stopped
ports:
- "9705:9705"
volumes:
- /path/to/config:/config
- /path/to/media:/media # Optional — for Movie Hunt / TV Hunt library access
- /path/to/downloads:/downloads # Optional — for NZB Hunt download output
environment:
- TZ=America/New_York
- PUID=1000 # Optional — run as specific user ID (default: 0 = root)
- PGID=1000 # Optional — run as specific group ID (default: 0 = root)
Volume & Environment Reference
| Path / Variable | Required | Purpose |
|---|---|---|
/config |
Yes | Persistent config, database, and settings |
/media |
No | Media library root for Movie Hunt / TV Hunt |
/downloads |
No | NZB Hunt download output directory |
TZ |
No | Timezone (e.g. America/New_York, default: UTC) |
PUID |
No | User ID to run as (default: 0 = root). Unraid: 99, Linux: 1000 |
PGID |
No | Group ID to run as (default: 0 = root). Unraid: 100, Linux: 1000 |
More Installation Methods
Once running, open your browser to http://<your-server-ip>:9705.
For full documentation, visit the Huntarr Wiki.
The Classic
For those who remember where it all started.
Other Projects
- HuntarrOS — Self-hosted server management platform with Docker app store, reverse proxies, and MergerFS — https://HuntarrOS.com
- Seekandwatch — A streamlined media discovery and watchlist tool for finding and tracking content across your media stack
- Unraid Intel ARC Deployment — Convert videos to AV1 format
Huntarr + Cleanuparr
Huntarr fills your library. Cleanuparr protects it.
While Huntarr is out hunting for missing content and upgrading quality, Cleanuparr watches your download queue like a hawk — removing stalled downloads, blocking malicious files, and cleaning up the clutter that builds up over time. One brings content in, the other makes sure only clean downloads get through.
Together they form a self-sustaining media automation loop: Huntarr searches, Cleanuparr filters, and your library grows with zero manual intervention.
Contributors
Change Log
Visit the Releases page.
License
Licensed under the GNU General Public License v3.0.