How jilvo/senscritique-to-seerr works
SensCritique → Seerr is a CLI tool for checking film and series collections against Seerr, reporting availability, and optionally creating requests. The main workflow fetches collections, matches titles to Seerr/TMDB records, combines media and request statuses, then reports results; request commands use the resulting matches to submit requests. The README also documents series-season handling, cache rebuilding, and CSV output. Arrows reflect shown calls or documented behavior; unsampled CLI and service details are represented only where the README supports them.
Main entry points: cli.py Commands · pipeline.py Status pipeline · seerr.py Seerr client · senscritique.py Collection client
Components 17
CLI and output
- Commands
src/sc_to_seerr/cli.py - Configuration
src/sc_to_seerr/config.py - Logging
src/sc_to_seerr/logging_setup.py - Reports and CSV
src/sc_to_seerr/report.py
Matching workflow
- Status pipeline
src/sc_to_seerr/pipeline.py - Title matching
src/sc_to_seerr/matching.py - Match cache
src/sc_to_seerr/cache.py - Domain models
src/sc_to_seerr/models.py
Remote services
- Collection client
src/sc_to_seerr/services/senscritique.py - Seerr client
src/sc_to_seerr/services/seerr.py - HTTP base client
src/sc_to_seerr/services/base.py
Requests and series
- Movie requests
src/sc_to_seerr/requester.py - Series and seasons
src/sc_to_seerr/cli.py
Other components
- CLI user
- SensCritique GraphQL
- Seerr API
- JSON cache files
Connections 20
- CLI user → Commands: runs commands
README.md - Commands → Configuration: loads settings
src/sc_to_seerr/cli.py - Commands → Logging: configures logs
src/sc_to_seerr/cli.py - Commands → Status pipeline: runs checks
src/sc_to_seerr/cli.py - Status pipeline → Collection client: fetches collections
src/sc_to_seerr/pipeline.py - Status pipeline → Seerr client: fetches statuses
src/sc_to_seerr/pipeline.py - Status pipeline → Seerr client: searches titles
src/sc_to_seerr/pipeline.py - Status pipeline → Title matching: checks candidates
src/sc_to_seerr/pipeline.py - Status pipeline → Match cache: reads and saves
src/sc_to_seerr/pipeline.py - Status pipeline → Reports and CSV: provides results
README.md - Commands → Reports and CSV: prints and exports
README.md - Collection client → SensCritique GraphQL: reads collections
README.md - Seerr client → Seerr API: queries and requests
README.md - Collection client → HTTP base client: uses client
src/sc_to_seerr/services/senscritique.py - Seerr client → HTTP base client: uses client
src/sc_to_seerr/services/seerr.py - Commands → Movie requests: submits movie requests
src/sc_to_seerr/cli.py - Movie requests → Seerr client: creates requests
src/sc_to_seerr/requester.py - Commands → Series and seasons: handles series commands
README.md - Series and seasons → Seerr client: checks seasons and requests
README.md - Match cache → JSON cache files: reads and writes
src/sc_to_seerr/cache.py