Stop Missing Out: Effortlessly Find and Upgrade Your Media with Huntarr

Tired of missing episodes or settling for low-quality versions of your favorite movies? Huntarr is the solution to automatically hunt down missing media and upgrade existing files to the best quality available. Learn how to install and configure this powerful tool to maintain a pristine media library.

What is Huntarr and Why Do You Need It?

Huntarr is a background application designed to continuously scan your media libraries for two key improvements:

• Missing Content: Automatically identifies and searches for episodes or movies that are missing from your collection.
• Quality Upgrades: Finds and upgrades media files that don't meet your desired quality standards, ensuring you always have the best viewing experience.

Huntarr helps you complete your media collection with the best available quality through continuous automation to do all the work for you.

Key Benefits of Using Huntarr

• Automated Media Management: Automates repetitive tasks, saving you time and effort in building a complete media library.
• Improved Media Quality: Upgrades media to your preferred quality settings without manual intervention.
• Indexer-Friendly: Designed to respect indexer rate limits, ensuring smooth and reliable operation.

How Huntarr Works: The Continuous Automation Cycle

Huntarr operates on a simple yet effective cycle:

1. Scanning: Regularly scans your media libraries using your *Arr applications.
2. Detection: Identifies missing items and those below your defined quality threshold.
3. Searching: Automatically initiates searches for the missing or upgrade candidate items.
4. Updating: Seamlessly integrates the new, high-quality media into your existing library.

This continuous cycle ensures your media collection is always up-to-date and of the highest possible quality.

Installation Guide: Docker and Unraid Options

Method 1: Docker Run Installation

This is the easiest and preferred installation method.

1. Run the following Docker command:

   docker run -d --name huntarr \
   --restart always \
   -p 9705:9705 \
   -v /your-path/huntarr:/config \
   -e TZ=America/New_York \
   huntarr/huntarr:latest
   

   Copy

2. Replace /your-path/huntarr with the actual path to your desired config directory.

3. Access the web interface by navigating to http://YOUR_SERVER_IP:9705 in your browser.

Method 2: Docker Compose Installation

1. Add the following to your docker-compose.yml file:

   services:
     huntarr:
       image: huntarr/huntarr:latest 
       container_name: huntarr 
       restart: always 
       ports:
         - "9705:9705" 
       volumes:
         - /your-path/huntarr:/config 
       environment:
         - TZ=America/New_York
   

   Copy

2. Replace /your-path/huntarr with the actual path to your desired config directory.

3. Run docker-compose up -d huntarr to start the container.

Method 3: Unraid Installation

1. Run the following command in the Unraid command line:

   docker run -d --name huntarr \
   --restart always \
   -p 9705:9705 \
   -v /mnt/user/appdata/huntarr:/config \
   -e TZ=America/New_York \
   huntarr/huntarr:latest
   

   Copy

2. The web interface will be accessible at http://YOUR_SERVER_IP:9705.

Web Interface: Your Central Control Panel

Huntarr features an intuitive web interface accessible via http://YOUR_SERVER_IP:9705. Here, you can:

• Monitor Hunts: View statistics on missing media searches and upgrade hunts.
• Configure Settings: Adjust all Huntarr settings, including API connections and search frequency.
• Real-Time Logs: Monitor Huntarr's activities.

Essential Huntarr Configuration Tips

• First-Time Setup: Create your admin account with 2FA (two-factor authentication) for enhanced security.
• API Connections: Configure connections to Sonarr, Radarr, and other *Arr applications in the settings.
• Search Frequency: Adjust the "Sleep Duration" based on your indexer's rate limits.
• Batch Processing: Control the number of items processed per cycle with the "Hunt Missing" and "Upgrade" settings.
• Queue Management: Use "Minimum Download Queue Size" to pause searching when downloads back up.

Troubleshooting Common Issues

• API Connection Problems: Double-check your API key and URL in the settings (ensure that you include the http:// or https://).
• Authentication Failures: If you've forgotten your password, delete /config/user/credentials.json and restart Huntarr.
• Web Interface Issues: Confirm that port 9705 is correctly mapped and not blocked by any firewalls.

By following this guide, you can harness the power of Huntarr to effortlessly maintain a complete and high-quality media library.