How sunetworkingnerd/ytdlp-gui works
yt-dlp GUI is a PySide6 desktop front end for configuring and running yt-dlp. The main workflow is: enter a URL, optionally fetch its metadata and formats, configure download options, then run and monitor jobs in the queue. A separate channel-archive workflow builds yt-dlp arguments for resumable, configurable channel downloads. The README documents cookies/login, live-stream controls, and theme preferences as additional capabilities. The graph uses the shown source and README; some UI-to-runtime connections rely on the source index, so unsampled details are not expanded.
Main entry points: main_window.py Main window · runner.py Process runner · __main__.py App entry · archive_dialog.py Archive dialog
Components 16
Application UI
- App entry
ytdlp_gui/__main__.py - Main window
ytdlp_gui/ui/main_window.py - Queue and jobs
ytdlp_gui/ui/main_window.py
Download Workflows
- Archive dialog
ytdlp_gui/ui/archive_dialog.py - Archive arguments
ytdlp_gui/core/archive.py - Info fetch
ytdlp_gui/core/metadata.py - Cookie arguments
ytdlp_gui/core/cookies.py - Live controls
ytdlp_gui/ui/main_window.py
Download Core
- Process runner
ytdlp_gui/core/runner.py
Options and Appearance
- Options panel
ytdlp_gui/ui/options_panel.py - Option model
ytdlp_gui/core/options_model.py - Theme application
ytdlp_gui/ui/theme.py - Theme choices
ytdlp_gui/core/theme.py
Other components
- User
- yt-dlp
- Download files
Connections 20
- User → Main window: enters URLs
README.md - App entry → Option model: creates model
ytdlp_gui/__main__.py - App entry → Main window: opens window
ytdlp_gui/__main__.py - App entry → Theme application: applies theme
ytdlp_gui/__main__.py - Main window → Options panel: creates panel
ytdlp_gui/ui/main_window.py - Options panel → Option model: renders options
ytdlp_gui/ui/options_panel.py - Main window → Info fetch: fetches info
ytdlp_gui/ui/main_window.py - Info fetch → Process runner: uses run settings
ytdlp_gui/core/metadata.py - Main window → Cookie arguments: builds cookie args
ytdlp_gui/ui/main_window.py - Main window → Live controls: configures streams
README.md - Main window → Archive dialog: opens dialog
ytdlp_gui/ui/main_window.py - Archive dialog → Archive arguments: builds arguments
ytdlp_gui/ui/archive_dialog.py - Archive dialog → Process runner: checks tools
ytdlp_gui/ui/archive_dialog.py - Main window → Archive arguments: runs archive
README.md - Main window → Queue and jobs: manages jobs
ytdlp_gui/ui/main_window.py - Queue and jobs → Process runner: starts and stops
README.md - Process runner → yt-dlp: launches process
ytdlp_gui/core/runner.py - yt-dlp → Download files: writes downloads
README.md - Theme application → Theme choices: resolves choice
ytdlp_gui/ui/theme.py - User → Theme application: chooses appearance
README.md