Splintarr v1.0.0-alpha

First alpha release — ready for testing by homelab enthusiasts.

Highlights

• Intelligent Search Engine — Automated backlog searching with multiple strategies (missing, cutoff unmet, recent), per-episode tracking, season pack detection with fallback, and search result feedback
• Library Overview — Visual poster grid with episode-level completion, quality profiles, missing/cutoff filtered views
• Prowlarr Integration — Indexer-aware rate limiting to prevent bans
• Discord Notifications — Alerts for search activity, instance health, and errors
• Setup Wizard — Guided 6-step setup for first-time users
• Security Hardened — SQLCipher encrypted database, Argon2id password hashing, JWT auth, TOTP 2FA, CSP nonce

Alpha Scope

• Sonarr only — Radarr support is planned for a future release (backend code exists, UI is gated)
• Tested on Docker Desktop for Windows — Expected to work on Linux/macOS but not independently verified

Quick Start

Windows

git clone https://github.com/menottim/splintarr.git
cd splintarr
.\scripts\setup-windows.ps1 -AutoStart

Linux / macOS

git clone https://github.com/menottim/splintarr.git
cd splintarr
./scripts/setup.sh --auto-start

Then open http://localhost:7337 to complete the setup wizard.

What's Changed Since v0.5.1

Bug Fixes

• Fixed database locking during library sync (removed per-connection auto_vacuum PRAGMA)
• Fixed raw JSON {"detail":"Not authenticated"} shown in browser (now redirects to login)
• Fixed library detail page crash (missing Jinja endblock + unregistered filters)
• Fixed sync overlay showing no progress (now shows stages, item counts, elapsed time)
• Fixed search queue repeatedly searching same episodes (per-episode tracking with 24h decay)
• Fixed season pack search blocking individual episode fallback
• Fixed onboarding "Sync now" link not triggering sync

New Features

• Edit active search queues (name, strategy, schedule, season pack settings)
• "Run Now" with cooldown override option on queue pages
• Cutoff Unmet library filter page
• Quality profile names displayed from Sonarr
• Click-to-copy URL suggestions for Prowlarr setup
• Linux/macOS setup script (setup.sh)
• Config export "import coming soon" note
• Search results update to "grabbed"/"no grab" after feedback check

UX Polish

• Compact numbered-circle setup wizard progress indicator
• Updated welcome page features and getting started tips for alpha
• Disabled Radarr in UI with "coming in future release" notes
• Dashboard: Recent Activity moved above Indexer Health
• Getting Started onboarding shown on Dashboard (not buried in empty states)
• Tooltip explanations for "searched" vs "eligible" counts
• Clickable search history entries link to queue detail
• All timestamps show UTC timezone
• Verify SSL toggle has explanatory hint
• Friendly error messages for bad Prowlarr/Discord URLs

Security

• Pre-alpha security audit: 0 Critical, 2 High (1 fixed, 1 documented)
• Sync status endpoint limited to minimal response for unauthenticated users

Infrastructure

• Logging overhaul: truncation (1-2KB), error deduplication, reduced rotation (5MB/3 backups)
• Code simplification: shared Jinja filters, extracted dialog components, removed dead code
• generate-secrets.sh parity with Windows version (auto-delete DB on regeneration)

Known Limitations

See RELEASE_NOTES.md for full details.

Feedback

Please report bugs and feedback at: https://github.com/menottim/splintarr/issues

🤖 Generated with Claude Code