How derpycat306/music_player works
This is an Electron desktop player for a locally owned music library. The user selects a library folder, browses artists, albums, playlists, or filtered songs, and plays tracks with persistent playback controls; favorites and playlists extend that workflow. Electron provides local-file access, saved settings, and update handling, while the React renderer owns browsing and playback interfaces. README capabilities include live library updates and folder-based artwork; sampled evidence does not expose all renderer-to-Electron wiring, so uncertain links are omitted.
Main entry points: App.tsx React application · MainWindow.tsx Main window · main.ts Desktop lifecycle · AudioPlayerProvider.tsx Player state
Components 26
Electron runtime
- Desktop lifecycle
src/electron/main.ts - Folder discovery
src/electron/songFolderReader.ts - Audio extensions
src/electron/extentionHandler.ts - Music protocol
src/electron/requestProtocol.ts - Saved data
src/electron/saveHandler.ts - Renderer bridge
src/electron/preload.cts - Release updates
src/electron/main.ts
Library and navigation
- Library state
src/ui/Pages/Main/ExplorerContext/ExplorerProvider.tsx - Folder browser
src/ui/Pages/Main/FileExplorer/FileExplorer.tsx - Library navigation
src/ui/Pages/Main/Header/MainHeader.tsx - Browse and detail
src/ui/Pages/Main/MainPanel/MainPanel.tsx - Song listing
src/ui/Pages/Main/SongListing/Songs/SongList.tsx - List virtualization
src/ui/Pages/Main/useVirtualList.ts - Artwork resolution
src/ui/artwork.ts
Playback and curation
- Player state
src/ui/AudioPlayer/AudioPlayerProvider.tsx - Player context
src/ui/AudioPlayer/AudioPlayerContext.tsx - Playback controls
src/ui/PlayBar/PlayBar.tsx - Song actions
src/ui/Pages/Main/SongListing/Songs/Item/SongItem.tsx - Favorite and playlist menu
src/ui/Pages/Main/SongListing/Songs/Item/SongContext.tsx - Context menu
src/ui/ContextMenu/ContextMenu.tsx
Application interface
- React application
src/ui/App/App.tsx - Main window
src/ui/Pages/Main/MainWindow.tsx - Settings screen
src/ui/Pages/Settings/SettingsMenu.tsx
Other components
- Listener
- Local music files
- Update service
Connections 31
- Desktop lifecycle → Folder discovery: initializes
src/electron/main.ts - Desktop lifecycle → Music protocol: initializes
src/electron/main.ts - Desktop lifecycle → Saved data: loads settings
src/electron/main.ts - Folder discovery → Audio extensions: checks formats
src/electron/songFolderReader.ts - Folder discovery → Saved data: uses saved data
src/electron/songFolderReader.ts - Music protocol → Local music files: serves local audio
- Desktop lifecycle → Release updates: handles update IPC
src/electron/main.ts - Release updates → Update service: checks and downloads
src/electron/main.ts - Listener → React application: uses
src/ui/App/App.tsx - React application → Main window: routes to
src/ui/App/App.tsx - React application → Settings screen: routes to
src/ui/App/App.tsx - React application → Library state: provides
src/ui/App/App.tsx - React application → Playback controls: renders
src/ui/App/App.tsx - Main window → Folder browser: renders
src/ui/Pages/Main/MainWindow.tsx - Main window → Library navigation: renders
src/ui/Pages/Main/MainWindow.tsx - Main window → Browse and detail: renders
src/ui/Pages/Main/MainWindow.tsx - Main window → Song listing: renders
src/ui/Pages/Main/MainWindow.tsx - Library state → Player state: uses playback
src/ui/Pages/Main/ExplorerContext/ExplorerProvider.tsx - Library state → Artwork resolution: resolves library art
src/ui/Pages/Main/ExplorerContext/ExplorerProvider.tsx - Browse and detail → List virtualization: virtualizes tracks
src/ui/Pages/Main/MainPanel/MainPanel.tsx - Browse and detail → Artwork resolution: resolves display art
src/ui/Pages/Main/MainPanel/MainPanel.tsx - Song listing → List virtualization: virtualizes rows
src/ui/Pages/Main/SongListing/Songs/SongList.tsx - Playback controls → Player state: reads controls
src/ui/PlayBar/PlayBar.tsx - Song actions → Player state: uses player state
src/ui/Pages/Main/SongListing/Songs/Item/SongItem.tsx - Song actions → Favorite and playlist menu: opens actions
src/ui/Pages/Main/SongListing/Songs/Item/SongItem.tsx - Favorite and playlist menu → Player state: updates favorites
src/ui/Pages/Main/SongListing/Songs/Item/SongContext.tsx - Favorite and playlist menu → Context menu: renders
src/ui/Pages/Main/SongListing/Songs/Item/SongContext.tsx - Player state → Player context: provides context
src/ui/AudioPlayer/AudioPlayerProvider.tsx - Renderer bridge → Desktop lifecycle: bridges IPC
- Settings screen → Saved data: reads and writes settings
- Folder discovery → Local music files: discovers local songs