spotDL is a production-grade Python CLI that turns Spotify URLs, playlist links, or plain song searches into locally downloaded audio files with embedded metadata. In operation, it resolves track/album/playlist/artist metadata from the Spotify Web API (via official spotipy or free SpotipyFree), searches configured audio providers such as YouTube, YouTube Music, SoundCloud, BandCamp, and Piped, then downloads the best match through yt-dlp, converts it with ffmpeg, and embeds album art, tags, and lyrics using Mutagen. Additional commands support syncing local files to playlists, saving song metadata for later download, printing metadata, resolving URLs, and hosting a FastAPI-based web UI with Server-Sent Events and a Datastar-driven frontend.
Pear Desktop is an Electron-based desktop application that wraps YouTube Music into a native-like experience with an extensive plugin system. It provides a custom UI built with SolidJS and Material Design 3 (via patched @mdui), system tray integration, media controls, and cross-platform support (Windows, macOS, Linux). The application enhances YouTube Music with over 50 plugins covering audio effects (equalizer, crossfade, compressor), visual customization (album color theme, ambient mode, transparent player), social integrations (Discord Rich Presence, Last.fm scrobbling, collaborative listening via Music Together), and utilities (downloader, synced lyrics, API server, sponsorblock). The architecture follows a clear separation of concerns: main process (Electron), renderer process (SolidJS), and a plugin lifecycle with backend, renderer, and menu contexts. Plugins are loaded dynamically via custom Vite virtual modules and communicate through IPC. The codebase demonstrates strong engineering practices with TypeScript, strict linting, automated CI/CD, and internationalization across 70+ languages. While heavily coupled to YouTube Music's internal APIs and DOM structure, the plugin system and utility abstractions (e.g., createPlugin, VolumeFader, ScrobblerBase) are well-designed and potentially reusable in other Electron music player projects.
SimpMusic is a production-grade Kotlin Multiplatform music player for Android and desktop (JVM) that streams from YouTube Music's undocumented backend. The codebase is organized around a shared Compose Multiplatform UI module (composeApp), Android entry points (androidApp), a desktop entry point (desktopApp), and optional feature modules for Google Cast, Last.fm scrobbling, and crash reporting. A separately referenced core submodule supplies domain and media-service logic. Internally it uses MVVM with Koin dependency injection, Repository interfaces backed by Room entities and DataStore, StateFlow-based ViewModels, and a large custom Compose component library covering home feed, library management, playlist sync, fullscreen player, lyrics, equalizer, podcasts, Android home-screen widgets, and a desktop mini-player. The app is shipped as a packaged consumer application with Play Store metadata, GitHub Actions, fastlane changelogs, and build variants that swap real integrations for empty stubs in FOSS builds.