Documentation

Scheduling

Control when and how often Huntarr hunts for your media.

Overview

  • Each app and instance can have its own schedule
  • Schedules control hunt frequency and item caps
  • The scheduler runs independently for each configured task

How Scheduling Works

  1. Huntarr's scheduler engine checks all active schedules
  2. When a schedule's interval has elapsed, a hunt cycle begins
  3. The cycle processes up to the configured cap of items
  4. After completing, the scheduler waits for the next interval

Creating a Schedule

  1. Go to Settings > Scheduling
  2. Select an App Type (Sonarr, Radarr, Movie Hunt, etc.)
  3. Select an Instance (or Global for all instances)
  4. Set the schedule type (Interval or Cron)
  5. Configure the timing and caps
  6. Save

Schedule Settings

SettingDescription
App TypeWhich app this schedule controls
InstanceSpecific instance or "Global" for all
Schedule TypeInterval (every N minutes) or Custom
IntervalMinutes between hunt cycles
Missing CapMax missing items to search per cycle
Upgrade CapMax items to upgrade per cycle
EnabledToggle this schedule on/off

Recommended Settings

AppIntervalMissing CapUpgrade CapNotes
Sonarr30 min53Episodes search quickly
Radarr60 min32Movies take longer to find
Lidarr60 min32Music indexers can be slow
Movie Hunt30 min53Uses own indexers

Tips

  • Start conservative and increase caps gradually
  • Too-aggressive schedules may trigger indexer rate limits
  • Use per-instance schedules to stagger load across instances
  • Global schedules apply to all instances of that app type
  • Check the Hunt Manager for schedule execution history
Rate limits

Setting very low intervals (under 15 minutes) with high caps may cause indexer bans. Start with 30-minute intervals.