How ten1o0/youtube-music-downloader works
Music Downloader lets people search for or submit YouTube music, download it for offline listening, and organize and play it locally; optional accounts sync libraries across devices. The graph separates client workflows, listening and organization, account features, and server-side services. README documents the product capabilities; the source index confirms server module references and selected client calls. Many listed subsystems were not sampled, so their internal call relationships are not inferred.
Main entry points: server.py HTTP API · player.js Player and queue · download.js Download workflow · auth.js Sign-in and session
Components 27
Client workflows
- App bootstrap
frontend/src/main.js - Search
frontend/src/features/search.js - Download workflow
frontend/src/features/download/download.js - Playlist import
frontend/src/features/import/import.js - Preview playback
frontend/src/features/preview.js
Listening and library
- Music library
frontend/src/features/library/library.js - Player and queue
frontend/src/features/player/player.js - Radio mode
frontend/src/features/radio/radio.js - Lyrics
frontend/src/features/lyrics.js - Playlists
frontend/src/features/playlists/playlists.js - Favorites
frontend/src/features/favorites/store.js - Listening history
frontend/src/features/history.js - Year summary
frontend/src/features/wrapped/historia.js - Local storage
frontend/src/core/storage.js
Account and sync
- Sign-in and session
frontend/src/features/auth.js - Cloud sync
frontend/src/features/sync/sync.js
Backend services
- HTTP API
backend/server.py - Download processing
backend/lotes.py - YouTube playlists
backend/listas_youtube.py - Playlist matching
backend/importar.py - Radio recommendations
backend/radio.py - Server database
backend/database.py
App platform
- Android app
mobile/android/app/src/main/java/es/dannarita/music/MainActivity.java
Other components
- Listener
- YouTube
- Google sign-in
- LRCLIB
Connections 37
- Listener → App bootstrap: uses
- App bootstrap → Download workflow: initializes
frontend/src/main.js - Listener → Search: searches
- Search → Download workflow: starts download
frontend/src/features/download/download.js - Listener → Download workflow: submits link
- Download workflow → HTTP API: requests download
frontend/src/features/download/download.js - HTTP API → Download processing: dispatches to
backend/server.py - Download processing → YouTube: fetches audio
- Download workflow → Music library: saves result
frontend/src/features/download/download.js - Download workflow → Listening history: records download
frontend/src/features/download/download.js - Listener → Playlist import: imports playlist
- Playlist import → Playlist matching: matches songs
- Listener → Preview playback: previews songs
- Preview playback → Player and queue: plays preview
frontend/src/features/preview.js - Listener → Player and queue: plays music
- Player and queue → Music library: resolves audio
frontend/src/features/player/player.js - Player and queue → Radio mode: requests radio
frontend/src/features/player/player.js - Radio mode → Radio recommendations: gets recommendations
- Player and queue → Lyrics: shows synced lyrics
frontend/src/features/player/player.js - Lyrics → LRCLIB: fetches lyrics
- Listener → Playlists: organizes songs
- Playlists → Player and queue: starts playlist
frontend/src/features/playlists/playlists.js - Listener → Favorites: marks favorites
- Listener → Listening history: views history
- Listener → Year summary: views year summary
- Music library → Local storage: persists library
- Player and queue → Local storage: records listens
- Listener → Sign-in and session: signs in
- Sign-in and session → Google sign-in: authenticates
frontend/src/features/auth.js - Sign-in and session → HTTP API: checks session
frontend/src/features/auth.js - Listener → Cloud sync: syncs account
- Cloud sync → HTTP API: sends account data
- HTTP API → Server database: persists account data
backend/server.py - HTTP API → YouTube playlists: dispatches to
backend/server.py - HTTP API → Playlist matching: dispatches to
backend/server.py - HTTP API → Radio recommendations: dispatches to
backend/server.py - Listener → Android app: installs app