Categories
Self-Hosted Library Management Rate Limiting Home Media Media Automation Arr Stack Companion Search SchedulerStars
Forks
Watchers
Developer links
Houndarr
Radarr, Sonarr, and their sibling apps watch RSS feeds for new releases but never go back for what your library is still missing, and Houndarr fills that gap by asking them to search in small, polite batches. It reads the wanted lists of every connected Radarr, Sonarr, Lidarr, Readarr, and Whisparr instance and sends a few search commands per cycle, so a big backlog drains over days instead of arriving as one Search All Missing burst. Each instance has its own batch size, sleep interval, hourly cap, per-item cooldown, and post-release grace period, plus an optional download-queue limit, allowed search windows such as 09:00-23:00, and tag filters that include or exclude items. Three independent passes run per instance: missing items, cutoff-unmet items below your quality profile, and upgrades for files that already meet cutoff, with the last two off until you enable them. Sonarr, Lidarr, and Readarr can search by season, artist, or author, and search order is random or oldest-first. The dashboard shows library health, recent hunts, hourly budgets, and a cooldown schedule per instance, with Run Now buttons for on-demand cycles. The Logs page records every search and skip with its reason in a filterable audit trail that copies as TSV. A key-gated widget endpoint feeds Homepage dashboards, and built-in login or reverse-proxy authentication protects the interface. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. AGPL-3.0 licensed.
Benefits
- Search Backlogs Without Indexer Bans
- Small batches, sleep intervals, per-item cooldowns, and hourly caps spread searches over hours and days, so a large missing backlog gets worked through without tripping an indexer's rate limit.
- Tune Every Instance Separately
- Each connected instance carries its own batch size, interval, cooldown, hourly cap, tag filters, and allowed time window, so a 4K Radarr can search more slowly than a standard one.
- Know Why Every Search Happened
- The Logs page records each search, skip, and error with its reason, such as on cooldown or hourly limit reached, and filters by instance, action, kind, and trigger before copying as TSV.
- Runs Privately On Your Server
- Houndarr sends no telemetry and by default contacts only the instances you configure, encrypts stored API keys at rest, and runs as one container with a SQLite database on your own server.
Features
- Three Independent Search Passes
- Missing, cutoff-unmet, and upgrade passes run separately for each instance with their own batch sizes, hourly caps, and cooldowns; cutoff and upgrade searches start disabled.
- Context Search Modes
- Sonarr and Whisparr v2 can search by season, Lidarr by artist, and Readarr by author, sending one SeasonSearch, ArtistSearch, or AuthorSearch command instead of many item searches.
- Live Instance Dashboard
- Per-instance cards show wanted, eligible, and searched counts, a cooldown schedule, an hourly budget meter, and a Run Now button, above a library health bar and recent hunts.
- Cycle-Based Audit Log
- Cycle cards group each run's searches and skips with their reasons, filter by instance, action, kind, and trigger, refresh live while you watch, and offer multi-format copy and export.
- Homepage Widget API
- A key-gated /api/v1/widget endpoint returns eligible, gated, unreleased, and seven-day search totals as JSON for Homepage customapi widgets; only a SHA-256 hash of the key is stored.
- Docker, Helm, And Proxy Auth
- Published as a multi-architecture image for linux/amd64 and linux/arm64, plus an OCI Helm chart, with bcrypt-protected built-in login or reverse-proxy header authentication.