How devine-dl/devine works
Devine is a modular media-archival CLI and framework: users invoke download or search commands, service plugins resolve titles and tracks, and the download workflow fetches, decrypts, processes, and names media output. The README also documents DASH/HLS parsing, Widevine and ClearKey, proxy providers, key vaults, remote CDMs, and serving. Edges are limited to relationships visible in excerpts, SOURCE INDEX references, or README statements; unsampled implementations are represented by their exact tree paths without asserting internal call sequences.
Main entry points: dl.py Download workflow · service.py Service framework · commands Command entrypoints · tracks Track processing
Components 19
CLI and configuration
- Command entrypoints
devine/commands - Download workflow
devine/commands/dl.py - Search command
devine/commands/search.py - Configuration
devine/core/config.py
Services and discovery
- Service registry
devine/core/services.py - Service framework
devine/core/service.py - Title models
devine/core/titles
Media acquisition
- DASH and HLS
devine/core/manifests - Track processing
devine/core/tracks - HTTP downloaders
devine/core/downloaders - Media utilities
devine/core/binaries.py - Archived media
DRM and vaults
- DRM handlers
devine/core/drm - Vault adapters
devine/vaults - Vault registry
devine/core/vaults.py
Runtime integrations
- Proxy providers
devine/core/proxies - Remote serving
devine/commands/serve.py - Event hooks
devine/core/events.py
Other components
- CLI user
Connections 24
- CLI user → Command entrypoints: invokes
README.md - Command entrypoints → Download workflow: routes downloads
devine/commands/dl.py - Command entrypoints → Search command: routes searches
devine/commands/search.py - Download workflow → Configuration: reads settings
devine/commands/dl.py - Download workflow → Service registry: selects service
devine/commands/dl.py - Search command → Service registry: selects service
devine/commands/search.py - Service registry → Service framework: loads plugins
devine/core/services.py - Service framework → Configuration: reads settings
devine/core/service.py - Service framework → Title models: returns title models
devine/core/service.py - Download workflow → Service framework: gets tracks
devine/commands/dl.py - Download workflow → Track processing: assembles tracks
devine/commands/dl.py - DASH and HLS → HTTP downloaders: fetches manifests
devine/core/manifests/dash.py - DASH and HLS → Track processing: creates tracks
devine/core/manifests/dash.py - Track processing → HTTP downloaders: downloads media
devine/core/tracks/track.py - Track processing → DRM handlers: uses DRM handlers
devine/core/tracks/track.py - Download workflow → Media utilities: uses media tools
devine/commands/dl.py - Download workflow → Archived media: writes archive
devine/commands/dl.py - Download workflow → DRM handlers: handles protected media
devine/commands/dl.py - DRM handlers → Vault registry: uses key vaults
- Vault registry → Vault adapters: loads adapters
devine/core/vaults.py - Vault adapters → HTTP downloaders: uses HTTP client
devine/vaults/API.py - Service framework → Proxy providers: supports proxies
devine/core/service.py - Command entrypoints → Remote serving: offers serving
README.md - Download workflow → Event hooks: emits events
devine/commands/dl.py