How bartolomeorusso9/spotiflac-module-version works
SpotiFLAC is an embeddable Python music-metadata and lossless-download module, with optional GUI, web API, and terminal UI. A typical request resolves Spotify URLs to track metadata, selects an installed extension provider, retrieves audio, and applies configured post-processing before saving the result. The README also documents independent features such as library management, subscriptions, statistics, and authenticated multi-user web access. The graph uses documented capabilities and SOURCE INDEX references; unsampled subsystems are represented conservatively, and their internal wiring is not inferred.
Main entry points: download_service.py Download service · routes.py REST API · pipeline.py Download pipeline · provider.py Extension provider
Components 23
User interfaces
- Python API
SpotiFLAC/client.py - GUI app
SpotiFLAC/app.py - Terminal UI
SpotiFLAC/tui/app.py
Download workflow
- Spotify metadata
SpotiFLAC/core/spotify_metadata.py - Download service
SpotiFLAC/application/download_service.py - Download pipeline
SpotiFLAC/application/pipeline.py - Download engine
SpotiFLAC/application/download_engine.py - Configuration
SpotiFLAC/core/config/__init__.py - Tagging and lyrics
SpotiFLAC/core/tagger.py - Audio transcoding
SpotiFLAC/core/transcode.py
Providers and extensions
- Extension manager
SpotiFLAC/extensions/manager.py - Extension provider
SpotiFLAC/extensions/provider.py - Registry settings
SpotiFLAC/extensions/registry_config.py
Library features
- Library deduplication
SpotiFLAC/core/library_dedup.py - Artist subscriptions
SpotiFLAC/core/subscriptions.py - Library upgrade
SpotiFLAC/core/library_upgrade.py
Web and persistence
- REST API
SpotiFLAC/webapi/routes.py - Durable job queue
SpotiFLAC/core/job_queue.py - Download log
SpotiFLAC/core/download_log.py - Download statistics
SpotiFLAC/core/stats.py - Outbound notifications
SpotiFLAC/core/notifiers.py
Other components
- Integrating user
- Music services
Connections 25
- Integrating user → Python API: calls API
- Integrating user → GUI app: uses GUI
- Integrating user → Terminal UI: uses TUI
- Integrating user → REST API: calls API
- Python API → Download service: submits downloads
SpotiFLAC/client.py - Python API → Spotify metadata: resolves tracks
SpotiFLAC/client.py - Download service → Download pipeline: runs pipeline
SpotiFLAC/application/download_service.py - Download service → Spotify metadata: resolves metadata
SpotiFLAC/application/download_service.py - Download service → Extension provider: tries candidates
SpotiFLAC/application/download_service.py - Download pipeline → Extension provider: resolves candidates
SpotiFLAC/application/pipeline.py - Download service → Download engine: adapts legacy downloads
SpotiFLAC/application/download_service.py - Download service → Configuration: uses settings
SpotiFLAC/application/download_service.py - Extension manager → Registry settings: loads settings
SpotiFLAC/extensions/manager.py - Extension manager → Extension provider: sets up providers
SpotiFLAC/extensions/provider.py - Extension provider → Music services: fetches audio
- Download pipeline → Tagging and lyrics: tags and writes lyrics
- Download pipeline → Audio transcoding: transcodes audio
- Integrating user → Library deduplication: checks library
- Integrating user → Artist subscriptions: follows artists
- Integrating user → Library upgrade: upgrades files
- REST API → Spotify metadata: resolves URLs
SpotiFLAC/webapi/routes.py - REST API → Durable job queue: queues work
SpotiFLAC/webapi/routes.py - REST API → Download log: reads download log
SpotiFLAC/webapi/routes.py - REST API → Download statistics: reads statistics
SpotiFLAC/webapi/routes.py - Integrating user → Outbound notifications: configures alerts