How ytdl-org/youtube-dl works
youtube-dl is a command-line and embeddable downloader that turns supplied URLs or search terms into selected media files. Its principal workflow is: accept options and targets, match a site extractor, resolve media metadata and formats (including playlist/search results), select formats, download media, then optionally postprocess it. The README also documents proxy and geo-bypass controls, flat playlists, subtitles, and extractor listing. The graph reflects these documented capabilities; sampled excerpts are partial, so some internal dispatch details are represented only at the documented subsystem level.
Main entry points: YoutubeDL.py Download coordinator · downloader Protocol downloaders · extractor Site extractors · __init__.py Downloader dispatch
Components 20
User entry
- CLI entry
youtube_dl/__main__.py - Python API
youtube_dl/__init__.py - Download coordinator
youtube_dl/YoutubeDL.py
Extraction
- Extractor registry
youtube_dl/extractor/__init__.py - Site extractors
youtube_dl/extractor - Extractor base
youtube_dl/extractor/common.py - Search extractor
youtube_dl/extractor/googlesearch.py - Format selection
youtube_dl/YoutubeDL.py
Download
- Downloader dispatch
youtube_dl/downloader/__init__.py - Protocol downloaders
youtube_dl/downloader - Fragment downloader
youtube_dl/downloader/fragment.py - External downloaders
youtube_dl/downloader/external.py
Output processing
- Postprocessor dispatch
youtube_dl/YoutubeDL.py - FFmpeg processing
youtube_dl/postprocessor/ffmpeg.py - Thumbnail embedding
youtube_dl/postprocessor/embedthumbnail.py
Runtime support
- Download cache
youtube_dl/cache.py
Other components
- CLI user
- Video platforms
- Media files
- Network services
Connections 26
- CLI user → CLI entry: provides targets
- CLI entry → Download coordinator: invokes
- CLI user → Python API: calls
- Python API → Download coordinator: creates
- Download coordinator → Extractor registry: loads extractors
- Extractor registry → Site extractors: registers
- Site extractors → Extractor base: inherits
- Download coordinator → Search extractor: dispatches search
- Search extractor → Network services: requests results
- Site extractors → Video platforms: extracts media info
- Site extractors → Download coordinator: returns metadata
- Download coordinator → Format selection: selects formats
- Download coordinator → Downloader dispatch: requests download
- Downloader dispatch → Protocol downloaders: dispatches download
- Protocol downloaders → Network services: fetches media
- Protocol downloaders → Media files: writes media
- Protocol downloaders → Fragment downloader: uses for fragments
- Fragment downloader → Protocol downloaders: downloads fragments
- Downloader dispatch → External downloaders: dispatches optionally
- External downloaders → Network services: fetches media
- Download coordinator → Postprocessor dispatch: runs processors
- Postprocessor dispatch → FFmpeg processing: invokes when configured
- Postprocessor dispatch → Thumbnail embedding: invokes when configured
- FFmpeg processing → Media files: transforms files
- Thumbnail embedding → Media files: embeds thumbnail
- Download coordinator → Download cache: uses cache