How feeluown/fuoevolve works
FuoEvolve is a cross-platform music player combining online providers, local and downloaded music, playback, lyrics, and video. The principal workflow is to discover or search for a track, add it to playback, resolve a playable source, and play it through a platform engine. Other documented capabilities include provider accounts and libraries, local playlists, downloads, recognition, and synchronized lyrics. The tree and excerpts establish the major modules, but do not show most application wiring; uncertain connections are therefore omitted or marked unverified.
Main entry points: ProviderRepositoryContracts.kt Provider contracts · PlaybackQueueController.kt Playback queue · HomeFeature.kt Home and discovery · PlaybackStartCoordinator.kt Playback start
Components 28
Application hosts
- Android app
androidApp/src/main/kotlin/org/feeluown/mobile/MainActivity.kt - Desktop app
desktopApp/src/main/kotlin/org/feeluown/mobile/nucleus/NucleusMain.kt - iOS app
iosApp/FuoEvolve/ContentView.swift
Discovery and providers
- Home and discovery
feature/home/src/commonMain/kotlin/org/feeluown/mobile/feature/home/HomeFeature.kt - Search
feature/search/src/commonMain/kotlin/org/feeluown/mobile/SearchFeature.kt - Provider catalog
feature/providercatalog/src/commonMain/kotlin/org/feeluown/mobile/ProviderCatalogFeature.kt - Provider accounts
feature/providerauth/src/commonMain/kotlin/org/feeluown/mobile/ProviderAuthFeature.kt - NetEase provider
provider/netease/src/commonMain/kotlin/org/feeluown/mobile/provider/netease/NeteaseProvider.kt - QQ Music provider
provider/qqmusic/src/commonMain/kotlin/org/feeluown/mobile/provider/qqmusic/QQMusicProvider.kt - Bilibili provider
provider/bilibili/src/commonMain/kotlin/org/feeluown/mobile/provider/bilibili/BilibiliProvider.kt - YouTube Music provider
provider/ytmusic/src/commonMain/kotlin/org/feeluown/mobile/provider/ytmusic/YtMusicPlayerClients.kt - Provider contracts
provider/api/src/commonMain/kotlin/org/feeluown/mobile/ProviderRepositoryContracts.kt
Playback
- Playback queue
feature/playback/src/commonMain/kotlin/org/feeluown/mobile/PlaybackQueueController.kt - Playback start
feature/playback/src/commonMain/kotlin/org/feeluown/mobile/PlaybackStartCoordinator.kt - Resolved source
feature/playback/src/commonMain/kotlin/org/feeluown/mobile/ResolvedPlaybackSource.kt - Playback session
playback/api/src/commonMain/kotlin/org/feeluown/mobile/playback/api/PlaybackSession.kt - Android playback
androidApp/src/main/kotlin/org/feeluown/mobile/AndroidNativeAudioEngine.kt - Desktop playback
desktopRuntime/src/main/kotlin/org/feeluown/mobile/desktop/DesktopMpvPlaybackEngine.kt - iOS playback
shared/src/iosMain/kotlin/org/feeluown/mobile/IosNativeAudioEngine.kt - Android media service
androidApp/src/main/kotlin/org/feeluown/mobile/FuoPlaybackService.kt - Lyrics publishing
androidApp/src/main/kotlin/org/feeluown/mobile/LyriconLyricsPublisher.kt
Music library
- Audio recognition
feature/recognition/src/commonMain/kotlin/org/feeluown/mobile/AudioRecognitionController.kt - Local music
feature/localmusic/src/commonMain/kotlin/org/feeluown/mobile/LocalMusicFeature.kt - Local playlists
feature/localplaylist/src/commonMain/kotlin/org/feeluown/mobile/LocalPlaylistFeature.kt - Downloads
feature/download/src/commonMain/kotlin/org/feeluown/mobile/DownloadFeature.kt - Android download storage
androidApp/src/main/kotlin/org/feeluown/mobile/AndroidDownloadRepository.kt - Listening history
persistence/listening/src/commonMain/kotlin/org/feeluown/mobile/persistence/listening/ListeningHistoryStore.kt
Other components
- Listener
Connections 26
- Listener → Android app: uses
- Listener → Desktop app: uses
- Listener → iOS app: uses
- Android app → Home and discovery: presents
- Desktop app → Home and discovery: presents
- iOS app → Home and discovery: presents
- Home and discovery → Provider catalog: browses
- Search → Provider contracts: searches
- Provider catalog → Provider contracts: uses
- Provider accounts → Provider contracts: authenticates
- NetEase provider → Provider contracts: implements
- QQ Music provider → Provider contracts: implements
- Bilibili provider → Provider contracts: implements
- YouTube Music provider → Provider contracts: implements
- Home and discovery → Playback queue: selects tracks
- Search → Playback queue: selects tracks
- Playback queue → Playback start: starts track
feature/playback/src/commonMain/kotlin/org/feeluown/mobile/PlaybackStartCoordinator.kt - Playback start → Provider contracts: resolves source
- Playback start → Resolved source: builds source
- Android playback → Android media service: connects controller
androidApp/src/main/kotlin/org/feeluown/mobile/AndroidNativeAudioEngine.kt - Android media service → Lyrics publishing: publishes lyrics
- Local music → Playback queue: selects tracks
- Local playlists → Playback queue: selects tracks
- Downloads → Android download storage: stores files
- Audio recognition → Search: finds matches
- Playback queue → Listening history: records listening