How charlespikachu/musicdl works
musicdl is a Python music and audiobook search/download client with adapters for streaming platforms, third-party music sites, and shared search services. The principal workflow is to configure selected sources, search them concurrently through MusicClient, then use a selected adapter to resolve and download audio. The graph preserves the documented adapter families and highlights the shared client and utility layers. Some adapter internals are unsampled, so their detailed calls and download flow are not expanded.
Main entry points: __init__.py Source registry · base.py Base client · kugou.py Kugou adapter · musicdl.py MusicClient
Components 20
Client orchestration
- MusicClient
musicdl/musicdl.py - Source registry
musicdl/modules/sources/__init__.py
Music platforms
- Platform adapters
musicdl/modules/sources - Kugou adapter
musicdl/modules/sources/kugou.py - NetEase adapter
musicdl/modules/sources/netease.py - QQ adapter
musicdl/modules/sources/qq.py - YouTube adapter
musicdl/modules/sources/youtube.py
Other discovery
- Audiobook adapters
musicdl/modules/audiobooks - Common search sources
musicdl/modules/common - Third-party music sites
musicdl/modules/thirdpartysites
Shared runtime
- Base client
musicdl/modules/sources/base.py - Utility exports
musicdl/modules/utils/__init__.py - Audio link validation
musicdl/modules/utils/misc.py - Host matching
musicdl/modules/utils/hosts.py - Kugou helpers
musicdl/modules/utils/kugouutils.py - YouTube helpers
musicdl/modules/utils/youtubeutils.py - Command helpers
musicdl/modules/utils/cmd.py - Logging
musicdl/modules/utils/logger.py
Other components
- Music listener
- Music services
Connections 20
- Music listener → MusicClient: uses
- MusicClient → Source registry: initializes sources
musicdl/musicdl.py - Source registry → Platform adapters: registers clients
musicdl/modules/sources/__init__.py - MusicClient → Platform adapters: searches concurrently
musicdl/musicdl.py - Platform adapters → Music services: searches and downloads
- Source registry → Audiobook adapters: imports clients
musicdl/modules/sources/__init__.py - Source registry → Common search sources: imports clients
musicdl/modules/sources/__init__.py - Source registry → Third-party music sites: imports clients
musicdl/modules/sources/__init__.py - Kugou adapter → Base client: inherits from
musicdl/modules/sources/kugou.py - NetEase adapter → Base client: inherits from
musicdl/modules/sources/netease.py - QQ adapter → Base client: inherits from
musicdl/modules/sources/qq.py - YouTube adapter → Base client: inherits from
musicdl/modules/sources/youtube.py - Base client → Utility exports: imports utilities
musicdl/modules/sources/base.py - Kugou adapter → Kugou helpers: uses helpers
musicdl/modules/sources/kugou.py - Kugou adapter → Host matching: uses host utilities
musicdl/modules/sources/kugou.py - NetEase adapter → Audio link validation: tests audio links
musicdl/modules/sources/netease.py - QQ adapter → Audio link validation: tests audio links
musicdl/modules/sources/qq.py - YouTube adapter → YouTube helpers: imports helpers
musicdl/modules/sources/youtube.py - Utility exports → Command helpers: exports commands
musicdl/modules/utils/__init__.py - Utility exports → Logging: exports logging
musicdl/modules/utils/__init__.py