How sureshsoudararajan/glypdl works
Glypdl is a cross-platform yt-dlp media downloader with native Android, Linux, and Windows apps, plus a browser extension that can send detected media to a desktop app. The typical workflow is to submit a URL, inspect media or playlist metadata, choose formats and authentication, then download and manage the resulting queue and history. The graph preserves those product stages and the major platform branches. Some desktop and Android subsystems are represented by their exact directories because their implementation was not sampled; connections to them are documented only where the excerpts or README support them.
Main entry points: YtDlpManager.kt yt-dlp engine · app.py Application orchestration · YtDlpService.cs yt-dlp service · App.xaml.cs WinUI application
Components 32
Android app
- Compose interface
android/app/src/main/java/com/glypdl/android/ui - Download workflow
android/app/src/main/java/com/glypdl/android/service/DownloadManager.kt - yt-dlp engine
android/app/src/main/java/com/glypdl/android/service/engine/YtDlpManager.kt - Foreground service
android/app/src/main/java/com/glypdl/android/service/DownloadForegroundService.kt - Download notifications
android/app/src/main/java/com/glypdl/android/service/DownloadNotificationManager.kt - Cookie authentication
android/app/src/main/java/com/glypdl/android/service/auth/AuthCookieManager.kt - Settings storage
android/app/src/main/java/com/glypdl/android/data/repository/SettingsRepository.kt - Media request formats
android/app/src/main/java/com/glypdl/android/data/model/DownloadRequest.kt
Linux app
- GTK application
src/glypdl/window.py - Application orchestration
src/glypdl/app.py - Media metadata
src/glypdl/services/metadata.py - Download service
src/glypdl/services/downloader.py - yt-dlp service
src/glypdl/services/ytdlp.py - Browser cookies
src/glypdl/services/cookies.py - Download history
src/glypdl/services/history.py - Extension IPC
src/glypdl/services/ipc.py - App data paths
src/glypdl/utils/paths.py
Windows app
- WinUI application
windows/src/Glypdl.Windows/App.xaml.cs - Desktop views
windows/src/Glypdl.Windows/Views - Download and queue
windows/src/Glypdl.Windows/Services/DownloadService.cs - Media metadata
windows/src/Glypdl.Windows/Services/MetadataService.cs - yt-dlp service
windows/src/Glypdl.Windows/Services/YtDlpService.cs - Browser cookies
windows/src/Glypdl.Windows/Services/CookieService.cs - Settings service
windows/src/Glypdl.Windows/Services/ISettingsService.cs
Browser extension
- Media detection
extension/src/detection - Page integration
extension/src/content - Background commands
extension/src/background - Desktop connection
extension/src/background/connection/ConnectionManager.ts
Media and preferences
- Media sites
- yt-dlp
- Downloaded media
Other components
- User
Connections 39
- User → Compose interface: submits URL
- Compose interface → Download workflow: requests download
android/app/src/main/java/com/glypdl/android/service/DownloadManager.kt - Download workflow → yt-dlp engine: runs download
android/app/src/main/java/com/glypdl/android/service/DownloadManager.kt - Download workflow → Foreground service: starts service
android/app/src/main/java/com/glypdl/android/service/DownloadManager.kt - Foreground service → Download notifications: updates notices
android/app/src/main/java/com/glypdl/android/service/DownloadForegroundService.kt - yt-dlp engine → Cookie authentication: gets cookies
android/app/src/main/java/com/glypdl/android/service/engine/YtDlpManager.kt - yt-dlp engine → Settings storage: reads settings
android/app/src/main/java/com/glypdl/android/service/engine/YtDlpManager.kt - yt-dlp engine → Media request formats: uses request formats
android/app/src/main/java/com/glypdl/android/service/engine/YtDlpManager.kt - yt-dlp engine → yt-dlp: extracts media
- yt-dlp engine → Downloaded media: produces files
- User → GTK application: submits URL
- GTK application → Application orchestration: handled by app
src/glypdl/app.py - Application orchestration → Media metadata: sets up service
src/glypdl/app.py - Application orchestration → Download service: sets up service
src/glypdl/app.py - Application orchestration → Download history: sets up service
src/glypdl/app.py - Application orchestration → Browser cookies: sets up service
src/glypdl/app.py - Application orchestration → Extension IPC: starts IPC
src/glypdl/app.py - Download service → yt-dlp service: uses engine
- yt-dlp service → yt-dlp: extracts media
- yt-dlp service → Downloaded media: produces files
- Browser cookies → App data paths: uses app paths
src/glypdl/services/cookies.py - Extension IPC → App data paths: uses socket paths
- User → Desktop views: submits URL
- WinUI application → Media metadata: constructs service
windows/src/Glypdl.Windows/App.xaml.cs - WinUI application → Download and queue: constructs service
windows/src/Glypdl.Windows/App.xaml.cs - WinUI application → Settings service: constructs service
windows/src/Glypdl.Windows/App.xaml.cs - Media metadata → yt-dlp service: uses engine
windows/src/Glypdl.Windows/Services/MetadataService.cs - Download and queue → yt-dlp service: uses engine
- yt-dlp service → Settings service: reads settings
windows/src/Glypdl.Windows/Services/YtDlpService.cs - yt-dlp service → yt-dlp: extracts media
- yt-dlp service → Downloaded media: produces files
- WinUI application → Browser cookies: constructs service
windows/src/Glypdl.Windows/App.xaml.cs - Browser cookies → yt-dlp service: uses engine interface
windows/src/Glypdl.Windows/Services/CookieService.cs - User → Page integration: visits page
- Page integration → Media detection: detects media
- Media detection → Background commands: sends detections
extension/src/background/context_menu.ts - Background commands → Desktop connection: sends download
extension/src/background/connection/ConnectionManager.ts - Media sites → Media detection: provides media
- Desktop connection → Extension IPC: sends native message