gas85/sh-seekarr repository overview

⁠sh-seekarr.sh

Source Code Repository: https://github.com/GAS85/sh-seekarr⁠

Donations:

A lightweight, dependency-free replacement for the seekarr⁠ and seekarr⁠ projects.

It queries Sonarr and/or Radarr for missing and/or cutoff-unmet ("upgrade") items, randomly selects up to a configurable limit, and triggers a targeted search for just those items — instead of hammering every wanted item at once.

⁠Why not just use seekarr?

The Typescript-based seekarr project loads node image and packages that is not memory efficient at all, only idle mode requeues 50 MBs of RAM and 150+ MB docker image.

The Python-based seekarr kind of the same and is overloaded with functions and UI.

No Python, no Typescript no persistent state, no database.

⁠How it works

1. For each configured app (Sonarr, Radarr, or both), pages through the wanted/missing and/or wanted/cutoff endpoints, depending on SHSEEKARR_SEARCH_MODE.
2. Optionally filters to monitored-only items, both via the API's monitored query param and a client-side re-check (in case the Sonarr/Radarr version being talked to ignores the query param).
3. Deduplicates and randomly shuffles the resulting id list (sort -uR).
4. Takes the first SHSEEKARR_LIMIT (or per-app override) items.
5. Logs what was picked, by name — e.g. Breaking Bad S04E04 for Sonarr, Heat (1995) for Radarr.
6. Triggers a single search command (EpisodeSearch / MoviesSearch) for exactly those items — or, if SHSEEKARR_DRY_RUN=true, just prints what would be sent.

An app is skipped automatically if its URL or API key isn't configured, so you can safely run this with only Sonarr, only Radarr, or both.

⁠Quick start

⁠Docker

docker run --name sh-seekarr \
	-e "SHSEEKARR_SONARR_URL=http://sonarr:8989/" \
	-e "SHSEEKARR_SONARR_APIKEY=your key" \
	-e "SHSEEKARR_RADARR_URL=http://radarr:7878/" \
	-e "SHSEEKARR_RADARR_APIKEY=your key" \
	--restart no \
	gas85/sh-seekarr:latest

⁠Docker-compose

Please refer to docker-compose.yml⁠ example.