How maotoumao/musicfree works
MusicFree is a mobile music player whose audio sources and catalog operations are supplied by user-installed plugins. Users can search for music, explore plugin-provided albums, artists, charts and playlists, then play tracks, manage collections, view lyrics, and download or access local music. The map groups those user-facing capabilities with playback, plugin, and local-state layers. README documents plugin capabilities; sampled source confirms selected wiring, so unverified connections are omitted.
Main entry points: pluginManager/index.ts Plugin manager · bootstrap.ts Bootstrap · lyricManager.ts Lyrics manager · trackPlayer/index.ts Track player
Components 24
App and navigation
- App entry
src/entry/index.tsx - Bootstrap
src/entry/bootstrap/bootstrap.ts - Screen routes
src/core/router/routes.tsx
Music discovery
- Music search
src/pages/searchPage/hooks/useSearch.ts - Artist works
src/pages/artistDetail/hooks/useQuery.ts - Album tracks
src/pages/albumDetail/hooks/useAlbumMusicList.ts - Charts and lists
src/pages/topListDetail/hooks/useTopListDetail.ts - Recommended sheets
src/pages/recommendSheets/hooks/useRecommendSheets.ts - Plugin sheets
src/pages/pluginSheetDetail/hooks/usePluginSheetMusicList.ts
Playback and lyrics
- Track player
src/core/trackPlayer/index.ts - Now playing
src/pages/musicDetail/index.tsx - Lyrics manager
src/core/lyricManager.ts - Lyric search
src/components/panels/types/searchLrc/useSearchLrc.ts - Native lyric utility
src/native/lyricUtil/index.ts
Plugin integrations
- Plugin manager
src/core/pluginManager/index.ts - Plugin modules
src/core/pluginManager/plugin.ts
Library and settings
- Local music
src/core/localMusicSheet.ts - Music sheets
src/core/musicSheet/index.ts - Listening history
src/core/musicHistory.ts - Downloads
src/core/downloader.ts - Settings and themes
src/pages/setting/index.tsx - Persisted state
src/utils/persistStatus.ts - Device files
src/utils/fileUtils.ts
Other components
- Listener
Connections 28
- Listener → App entry: opens app
src/entry/index.tsx - App entry → Bootstrap: starts
src/entry/index.tsx - App entry → Screen routes: registers screens
src/entry/index.tsx - Screen routes → Music search: routes to
src/core/router/routes.tsx - Screen routes → Now playing: routes to
src/core/router/routes.tsx - Music search → Plugin manager: queries plugins
src/pages/searchPage/hooks/useSearch.ts - Artist works → Plugin manager: gets plugin
src/pages/artistDetail/hooks/useQuery.ts - Album tracks → Plugin manager: gets tracks
src/pages/albumDetail/hooks/useAlbumMusicList.ts - Charts and lists → Plugin manager: gets chart
src/pages/topListDetail/hooks/useTopListDetail.ts - Recommended sheets → Plugin manager: gets sheets
src/pages/recommendSheets/hooks/useRecommendSheets.ts - Plugin sheets → Plugin manager: gets tracks
src/pages/pluginSheetDetail/hooks/usePluginSheetMusicList.ts - Plugin manager → Plugin modules: loads modules
src/core/pluginManager/index.ts - Bootstrap → Plugin manager: initializes
src/entry/bootstrap/bootstrap.ts - Bootstrap → Track player: initializes
src/entry/bootstrap/bootstrap.ts - Bootstrap → Music sheets: initializes
src/entry/bootstrap/bootstrap.ts - Bootstrap → Lyrics manager: initializes
src/entry/bootstrap/bootstrap.ts - Now playing → Track player: controls playback
- Track player → Lyrics manager: notifies track change
src/core/lyricManager.ts - Lyrics manager → Plugin manager: searches lyrics
src/core/lyricManager.ts - Lyric search → Plugin manager: searches plugins
src/components/panels/types/searchLrc/useSearchLrc.ts - Lyrics manager → Native lyric utility: sets lyric text
src/core/lyricManager.ts - Lyrics manager → Device files: creates lyric directory
src/core/lyricManager.ts - Bootstrap → Local music: initializes
src/entry/bootstrap/bootstrap.ts - Bootstrap → Listening history: initializes
src/entry/bootstrap/bootstrap.ts - Bootstrap → Downloads: initializes
src/entry/bootstrap/bootstrap.ts - Settings and themes → Persisted state: configures
- Track player → Persisted state: saves playback state
src/core/trackPlayer/index.ts - Plugin manager → Persisted state: stores plugin metadata