Skip to content

Home

Jump to bottom
menottim edited this page Mar 6, 2026 · 19 revisions

Splintarr Wiki

Current Version: v1.3.2

Splintarr is an intelligent search scheduler for Sonarr. It fills the gap between RSS-based new release monitoring (what Sonarr does well) and backlog management (what it doesn't do at all). Radarr support is planned for a future release.

Quick Links
Getting Started Installation · Configuration
Features Search Intelligence · Health Monitoring · Notifications · Library Overview
Reference Architecture · API Reference · Search Strategies
Development Contributing · Release History

What Does Splintarr Do?

Sonarr and Radarr rely on RSS feeds for ongoing content — polling indexers every 15-60 minutes for newly posted releases. This handles future content but does nothing for backlogs. The built-in "Search All Missing" button sends all requests at once, overwhelming indexers.

Splintarr provides:

  • Scheduled, throttled backlog searching — search N items per run instead of everything at once
  • Custom strategy filters — target searches by year range, quality profile, and series status with combined Missing + Cutoff Unmet
  • Adaptive prioritization — recently aired content searched first, old unfindable content deprioritized
  • Tiered cooldowns — fresh content searched every 6 hours, old content every 7 days
  • Grab detection — learn whether searches actually result in downloads
  • Real-time WebSocket updates — single WS connection replaces all polling, with auto-reconnect and polling fallback
  • Live search progress — progress bar and streaming results on queue detail, running indicator on dashboard
  • Dry run / preview — see what would be searched before running, with scores and reasons
  • Search analytics — last 7 days trends with top searched series
  • Bulk queue operations — multi-select with bulk pause, resume, run, and delete
  • Automatic update checker — checks GitHub daily, dismissible dashboard banner
  • Demo mode — synthetic data on new installs so the dashboard looks alive before setup
  • Indexer budget visibility — progress bars on dashboard, budget alerts, smart batch auto-sizing
  • Series completion cards — visual completion progress on dashboard and Library page
  • Queue scheduling — daily/weekly modes with jitter, CronTrigger support
  • Config import/export — backup and restore configuration with encrypted secret re-entry
  • Health monitoring — auto-pause queues when instances go down, auto-resume on recovery
  • Discord notifications — 8 event types: search, queue failures, health, sync, updates, grabs, budget alerts

Design Principles

  1. Strategy isolation — Missing and Cutoff Unmet are fundamentally different intents and must never be combined
  2. Indexer respect — Never overwhelm indexers. Throttle intelligently, adapt to limits
  3. Transparency — Every search decision (why an item was searched, skipped, or deprioritized) is visible in logs
  4. Homelab-first — Docker-first, single-container, no external dependencies beyond Sonarr/Radarr
  5. Stay focused — Search automation only. Don't try to replace the *arr apps

Status

v1.3.2 — Windows Docker Fix

Ready for use by homelab enthusiasts. Tested on Docker Desktop for Windows. Sonarr only (Radarr planned). This is AI-generated code (Claude Code) — treat accordingly.

Clone this wiki locally