How nb-group/nb_music works
NB Music is an Electron-based cross-platform music player: users search and import music, manage playlists, then play audio with synchronized lyrics and optional video. The repository also includes a Flask service for Bilibili-backed login, playlists, and music mappings. The desktop flow and Bilibili favorites import are supported by excerpts and the README; other module wiring is included only where the SOURCE INDEX names the relationship. The backend’s routes and file-backed persistence are shown in excerpts, but the frontend-to-backend API wiring was not sampled.
Main entry points: script.js App Bootstrap · PlaylistManager.js Playlist & Queue · UIManager.js Interface · AudioPlayer.js Audio Player
Components 26
Desktop App
- App Bootstrap
src/script.js - Interface
src/javascript/UIManager.js - Settings
src/javascript/SettingManager.js
Music Discovery
- Music Search
src/javascript/MusicSearcher.js - Bilibili API
- NetEase API
- Favorites Import
src/javascript/MusiclistManager.js - URL Cache
src/javascript/CacheManager.js
Playback
- Playlist & Queue
src/javascript/PlaylistManager.js - Audio Player
src/javascript/AudioPlayer.js - Lyrics Player
src/javascript/LyricsPlayer.js - Video Player
src/javascript/VideoPlayerManager.js - Audio Effects
src/javascript/EffectManager.js
Personal Library
- Favorites
src/javascript/FavoriteManager.js - Local Import
src/javascript/LocalImportManager.js - Account Login
src/javascript/LoginManager.js - Browser Storage
Backend Service
- Flask App
server/app.py - Login Routes
server/routes/auth_routes.py - Session Auth
server/utils/auth.py - Playlist Routes
server/routes/playlist_routes.py - Mapping Routes
server/routes/mapping_routes.py - Playback Routes
server/routes/play_routes.py - JSON Storage
server/utils/file_storage.py
Other components
- Listener
- Bilibili Service
Connections 48
- Listener → Interface: operates
README.md - App Bootstrap → Music Search: initializes
src/script.js - App Bootstrap → Playlist & Queue: initializes
src/script.js - App Bootstrap → Audio Player: initializes
src/script.js - App Bootstrap → Interface: initializes
src/script.js - App Bootstrap → Settings: initializes
src/script.js - App Bootstrap → Favorites Import: initializes
src/script.js - App Bootstrap → Favorites: initializes
src/script.js - App Bootstrap → Local Import: initializes
src/script.js - App Bootstrap → Account Login: initializes
src/script.js - App Bootstrap → Video Player: initializes
src/script.js - App Bootstrap → Audio Effects: initializes
src/script.js - Interface → Playlist & Queue: controls
src/javascript/UIManager.js - Interface → Music Search: fetches lyrics
src/javascript/UIManager.js - Interface → Settings: reads settings
src/javascript/UIManager.js - Music Search → Bilibili API: searches media
README.md - Music Search → NetEase API: fetches lyrics
README.md - Favorites Import → Bilibili API: imports favorites
src/javascript/MusiclistManager.js - Favorites Import → Playlist & Queue: adds playlists
src/javascript/MusiclistManager.js - Playlist & Queue → Music Search: gets audio links
src/javascript/PlaylistManager.js - Playlist & Queue → URL Cache: caches URLs
README.md - Playlist & Queue → Audio Player: sets audio source
src/javascript/PlaylistManager.js - Playlist & Queue → Browser Storage: saves progress
README.md - Audio Player → Playlist & Queue: requests retry
src/javascript/AudioPlayer.js - Audio Player → Lyrics Player: syncs playback
README.md - Audio Player → Video Player: syncs progress
README.md - Audio Effects → Audio Player: processes audio
src/javascript/EffectManager.js - Audio Effects → Settings: reads settings
src/javascript/EffectManager.js - Favorites → Playlist & Queue: selects songs
src/javascript/FavoriteManager.js - Favorites → Interface: refreshes display
src/javascript/FavoriteManager.js - Favorites → Browser Storage: persists favorites
README.md - Settings → Browser Storage: stores configuration
README.md - Video Player → Playlist & Queue: gets video URL
src/javascript/VideoPlayerManager.js - Account Login → Interface: updates interface
src/javascript/LoginManager.js - Account Login → Bilibili Service: authenticates
- Flask App → Login Routes: registers routes
server/app.py - Flask App → Playlist Routes: registers routes
server/app.py - Flask App → Mapping Routes: registers routes
server/app.py - Flask App → Playback Routes: registers routes
server/app.py - Login Routes → Bilibili Service: verifies identity
server/routes/auth_routes.py - Login Routes → Session Auth: creates session
server/routes/auth_routes.py - Login Routes → JSON Storage: stores sessions
server/routes/auth_routes.py - Session Auth → JSON Storage: loads sessions
server/utils/auth.py - Playlist Routes → Session Auth: checks access
server/routes/playlist_routes.py - Playlist Routes → JSON Storage: reads and writes
server/routes/playlist_routes.py - Mapping Routes → Session Auth: checks access
server/routes/mapping_routes.py - Mapping Routes → JSON Storage: reads and writes
server/routes/mapping_routes.py - Playback Routes → Session Auth: checks access
server/routes/play_routes.py