🚀 Scraparr v3.0.0
This release marks the official stable release of Scraparr v3.
It introduces a major internal refactor, significant performance improvements, new integrations, and improved configuration handling.
Warning
This is a major version upgrade.
While metric compatibility has been preserved where possible, the internal architecture and configuration behavior have changed.
Reviewing your setup after upgrading is recommended.
✨ TL;DR – Highlights
- 🧱 Major v3 refactor with class-based modules and cleaner architecture
- ⚡ Performance improvements (parallel API calls, connection pooling, fewer queries)
- 🎵 Lidarr support added
- 📚 Kavita module added
- 📊 Expanded Prowlarr metrics
- ⚙️ Environment variables now override YAML config
- 🧪 Added CI with pytest and migrated tooling to uv
- 📈 Improved Sonarr & Radarr dashboards
🧱 Architecture & Refactor
- Major v3 refactor with modules rewritten to be class-based
- Improved readability and reduced code duplication
- Utilities that require configuration were moved into the connector modules
- Internal structure cleaned up for long-term maintainability
⚡ Performance Improvements
- Eliminated N+1 API queries in Radarr movie fetching
- Added connection pooling using thread-local HTTP sessions
- Parallelized:
- Sonarr episode file fetching
- Seerr title API calls
- Optional Sonarr config to skip episode file API calls for faster scraping
🎉 New Features & Integrations
- Lidarr support for music library monitoring
- Kavita module added
- Additional metrics for Prowlarr
- Environment variable substitution supported in
config.yaml - Environment variables now override YAML config instead of acting as fallback
📊 Dashboards & Metrics
- Updated Sonarr and Radarr dashboards to sort quality and genre by count
- Fixed dashboard panels by switching job label matching to regex
- Fixed scrape interval handling
🛠️ Tooling & CI
- Added pytest CI workflow
- Migrated tooling to uv
🙌 New Contributors
Huge thanks to all first-time contributors in this release:
Your contributions pushed v3 over the finish line 💙
Thanks for the great help and the support on this Project
📜 Full Changelog:
Compare v2.2.5 → v3.0.0
👉 Repository: scraparr