Huntarr-Readarr

Overview

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

Requirements

Requires a separate Readarr v1 instance.

Runtime arguments

Network: bridge
Privileged: false

Template configuration

Readarr - URLVariable

URL of your Readarr instance

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

Readarr - API KeyVariable

API key for your Readarr instance

Target: API_KEY

Readarr - Monitored OnlyVariable

Only process monitored items

Target: MONITORED_ONLY
Default: true|false

Readarr - Skip Future ReleasesVariable

Skip processing books with release dates in the future

Target: SKIP_FUTURE_RELEASES
Default: true|false

Huntarr - Missing Books Per CycleVariable

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

Target: HUNT_MISSING_BOOKS
Default: 1
Value: 1

Huntarr - Upgrade Books Per CycleVariable

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

Target: HUNT_UPGRADE_BOOKS
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

Huntarr - Refresh Author MetadataVariable

Refresh author metadata before processing book

Target: REFRESH_AUTHOR
Default: true|false

Readarr - 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/4readarr:latest

Registry

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

Last Updated2025-04-07

First Seen2025-04-07

Run Huntarr-Readarr on Unraid.

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

Explore Unraid OS