Huntarr-Lidarr

Overview

DEPRECATED: Use Huntarr instead.
Huntarr (Lidarr Edition) continually searches your Lidarr library for missing music or music that need quality upgrades. It automatically triggers searches for both missing music and music below your quality cutoff. It's designed to run continuously while being gentle on your indexers, helping you gradually complete your music collection with the best available quality.

Requirements

Requires a separate Lidarr v1 instance.

Runtime arguments

Network: bridge
Privileged: false

Template configuration

Lidarr - URLVariable

URL of your Lidarr instance

Target: API_URL
Default: http://localhost:8686
Value: http://localhost:8686

Lidarr - API KeyVariable

API key for your Lidarr instance

Target: API_KEY

Lidarr - Monitored OnlyVariable

Only process monitored items

Target: MONITORED_ONLY
Default: true|false

Huntarr - ModeVariable

Which level to search for new releases at.

Target: HUNT_MISSING_MODE
Default: artist|album|both

Huntarr - Missing Items Per CycleVariable

Maximum missing items to process per cycle. Set to 0 to disable.

Target: HUNT_MISSING_ITEMS
Default: 1
Value: 1

Huntarr - Upgrade Albums Per CycleVariable

Maximum upgrade albums to process per cycle. Set to 0 to disable.

Target: HUNT_UPGRADE_ALBUMS
Default: 0
Value: 0

Huntarr - Use Random SelectionVariable

Use random selection for processing if enabled, or sequential if disabled.

Target: RANDOM_SELECTION
Default: false|true

Huntarr - Minimum Queue SizeVariable

Minimum number of items in the download queue before starting a hunt. Set to -1 to disable.

Target: MINIMUM_DOWNLOAD_QUEUE_SIZE
Default: -1
Value: -1

Lidarr - API TimeoutVariable

Timeout for API requests in seconds.

Target: API_TIMEOUT
Default: 60
Value: 60

Huntarr - Sleep DurationVariable

Duration, in seconds, to wait between cycles.

Target: SLEEP_DURATION
Default: 900
Value: 900

Huntarr - Reset IntervalVariable

Interval, in hours, after which to reset the processed state files. Set to 0 to disable.

Target: STATE_RESET_INTERVAL_HOURS
Default: 168
Value: 168

Debug ModeVariable

Enable debug mode for detailed logging.

Target: DEBUG_MODE
Default: false|true

Command Status - Wait TimeVariable

Delay in seconds between checking for command status

Target: COMMAND_WAIT_DELAY
Default: 1
Value: 1

Command Status - Max AttemptsVariable

Maximum number of attempts to check for command status

Target: COMMAND_WAIT_ATTEMPTS
Default: 600
Value: 600

Links

Template Support Docker Hub Project

Details

Repository

huntarr/4lidarr:latest

Registry

https://hub.docker.com/r/huntarr/4lidarr

Last Updated2025-04-07

First Seen2025-04-07

Run Huntarr-Lidarr on Unraid.

Huntarr-Lidarr is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS