Repolode
Submit
av1155

av1155/houndarr

Self-hosted companion for Radarr, Sonarr, Lidarr, Readarr and Whisparr that slowly searches for missing and below-cutoff media.

View on GitHubWebsite
Stars
308
Forks
4
Open issues
12
Last commit
2 days ago

What is it?

Houndarr is an automated search helper for the *arr media stack. Radarr, Sonarr, Lidarr, Readarr and Whisparr watch RSS feeds for new releases but do not systematically search for items already in your library that are missing or below your quality cutoff. Their built-in search-all button sends every request at once, which can exceed indexer API limits.

Houndarr works through the backlog in small batches, with sleep intervals between cycles, per-item cooldowns and a per-instance hourly API cap. It can also skip cycles when the download queue is full and restrict searches to configured time windows. It runs as a single Docker container with a FastAPI and HTMX web UI, offering a live dashboard, a filterable log viewer and multi-instance support.

Houndarr makes only read requests to your configured *arr instances plus search commands. It does not manage download clients, Prowlarr or indexers directly, and API keys are encrypted at rest.

Key features

  • 01Searches missing, cutoff-unmet and upgrade candidates across Radarr, Sonarr, Lidarr, Readarr and Whisparr
  • 02Small configurable batches with sleep intervals, per-item cooldowns and hourly API caps
  • 03Download-queue backpressure gate and optional per-instance time windows
  • 04Random or chronological search order per instance
  • 05Web dashboard with run-now buttons and a filterable log viewer
  • 06Runs as a single Docker container with Helm chart support

Use cases

  • Working through a large backlog of missing movies or episodes without tripping indexer rate limits
  • Running cutoff-upgrade searches overnight within a set time window
  • Monitoring several Sonarr and Radarr instances from one dashboard

Quick start

  1. 1

    Create a docker-compose.yml file with the Houndarr service definition

  2. 2

    Start Houndarr with Docker Compose

    docker compose up -d
  3. 3

    Open the web UI at http://<your-host>:8877 and create your admin account

Things to know

  • Requires running Docker and connecting it to your existing Radarr, Sonarr, Lidarr, Readarr or Whisparr instances.
  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source code when distributed or hosted.

In collections

Self-hosted apps

Topics

#media-automation#self-hosted#sonarr#radarr#docker#fastapi#htmx#python

FAQ

What is houndarr?
Self-hosted companion for Radarr, Sonarr, Lidarr, Readarr and Whisparr that slowly searches for missing and below-cutoff media. Houndarr is an automated search helper for the *arr media stack. Radarr, Sonarr, Lidarr, Readarr and Whisparr watch RSS feeds for new releases but do not systematically search for items already in your library that are missing or below your quality cutoff. Their built-in search-all button sends every request at once, which can exceed indexer API limits.
Is houndarr free to use? What license does it have?
houndarr is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is houndarr still maintained?
Actively maintained. The last commit to houndarr was on Nov 5, 2026.
What can I use houndarr for?
Working through a large backlog of missing movies or episodes without tripping indexer rate limits Running cutoff-upgrade searches overnight within a set time window Monitoring several Sonarr and Radarr instances from one dashboard
How do I install houndarr?
Create a docker-compose.yml file with the Houndarr service definition Start Houndarr with Docker Compose: docker compose up -d Open the web UI at http://<your-host>:8877 and create your admin account
Where can I get houndarr?
The source code and installation instructions are on GitHub: https://github.com/av1155/houndarr

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects