Huntarr - Find Missing & Upgrade Media Items

---

Want to Help? Click the Star in the Upper-Right Corner! ⭐

⭐ Show Your Support for Open Source!

If Huntarr has been helpful to you and you appreciate the power of open-source software, please consider giving this repository a star. Your gesture will greatly support our efforts and help others discover Huntarr!

Sonarr	Radarr	Lidarr	Readarr

Whisparr v2	Whisparr v3	Bazarr

Table of Contents

• Overview
• Why You Need Huntarr
• Other Projects
• Indexers Approving of Huntarr
• Installation Methods
• How It Works
• Thank You
• Screenshots
• The Perfect Pair: Huntarr & Cleanuperr
• Change Log

ℹ️ Overview

This application continually searches your media libraries for missing content and items that need quality upgrades. It automatically triggers searches for both missing items and those below your quality cutoff. It's designed to run continuously while being gentle on your indexers, helping you gradually complete your media collection with the best available quality.

For detailed documentation, please visit our Wiki.

❓ Why You Need Huntarr

Huntarr is an automatic missing content hunter for Sonarr, Radarr, Lidarr, Readarr, and Whisparr.
Think of it as the missing piece that actually completes your media automation setup by finding and downloading all the content your *arr apps aren't actively searching for.

The problem: Your *arr apps only monitor RSS feeds for new releases. They don't go back and search for missing episodes/movies already in your library. It's also a hard concept for many to understand the gap this creates.

The solution: Huntarr 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's the difference between having a "mostly complete" library and actually having everything you want.

🔀 Other Projects

• Unraid Intel ARC Deployment - Convert videos to AV1 Format (I've saved 325TB encoding to AV1)
• Visit PlexGuide for more great scripts

PayPal Donations – For My Daughter's College Fund

My 12-year-old daughter is passionate about singing, dancing, and exploring STEM. She consistently earns A-B honors! Every donation goes directly into her college fund!

👍 Indexers Approving of Huntarr:

• https://ninjacentral.co.za

⬇️ Installation Methods

• 🐋 Docker Installation
• 🪟 Windows Installation
• 🍏 macOS Installation
• 🔵 Unraid Installation
• 🔧 Alternative Methods

Special thanks to Nwithan8 for maintaining the Unraid templates and helping Huntarr grow through the Unraid Community Applications repository.

⚙️ How It Works

🔄 Continuous Automation Cycle

Connect & Analyze - Huntarr connects to your Sonarr/Radarr/Lidarr/Readarr/Whisparr/Eros instances and analyzes your media libraries to identify both missing content and potential quality upgrades.

Hunt Missing Content - Efficiently refreshes by skipping metadata to reduce disk I/O and database load, automatically skips content with future release dates, provides precise control over how many items to process per cycle, and focuses only on content you've marked as monitored.

Hunt Quality Upgrades - Finds content below your quality cutoff settings for improvement, uses batch processing to set specific numbers of upgrades per cycle, automatically pauses when download queue exceeds your threshold, and waits for commands to complete with consistent timeouts.

API Management - Implements hourly caps to prevent overloading your indexers, uses consistent API timeouts (120s) across all applications, identifies as Huntarr to all Arr applications with consistent headers, and provides visual indicators showing API usage limits.

Repeat & Rest - Huntarr waits for your configured interval (adjustable in settings) before starting the next cycle, ensuring your indexers aren't overloaded while maintaining continuous improvement of your library.

---

❤️ Thank You

A big thank you to these amazing contributors who've helped build and maintain this project:

📸 Screenshots

---

🤝 The Perfect Pair: Huntarr & Cleanuperr

+

Huntarr is the compulsive librarian who finds missing media and upgrades your existing content. It fills in the blanks and improves what you already have.

Cleanuperr () is the janitor of your server; it keeps your download queue spotless, removes clutter, and blocks malicious files.

When combined, these tools create a powerful, self-sufficient media automation stack:

• Huntarr hunts for content to add to your library
• Cleanuperr ensures only clean downloads get through
• Together, they create a reliable, hands-off media management system

Learn more about Cleanuperr at https://github.com/flmorg/cleanuperr

📜 Change Log

Visit: https://github.com/plexguide/Huntarr.io/releases/