FuoEvolve

FuoEvolve is an open-source music player based on the FeelUOwn ecosystem. Android is usable today. iOS support is planned, but the current iOS target is still a shell.

The project uses Kotlin Multiplatform and Compose Multiplatform for shared UI, state, and player contracts. On Android it packages the FeelUOwn Python core and provider plugins with Chaquopy, then plays audio and video through AndroidX Media3.

Highlights

- 🎵 FeelUOwn-based online music provider integration on Android. - 🔎 Search across enabled providers and local music, with provider filtering. - 🧭 Typed provider search tabs for songs, artists, albums, playlists, and videos where the upstream provider supports those result types. - 🏠 Provider home sections for recommendations, exploration, user playlists, and favorites. - ▶️ Media3 audio playback, video/MV playback, queue management, shuffle, repeat, up-next, multi-part tracks, covers, and LRC lyrics. - 🔁 Smart replacement for unavailable tracks, with configurable provider pool, score threshold, metadata policy, and lyric policy. - ⬇️ Downloads, app-private lyrics, local music database, local metadata edits, and provider-assisted metadata/lyric lookup. - 🔗 Direct system sharing with App Link-friendly share URLs. - ⚙️ Runtime settings for providers, login, quality, playback behavior, local scan filters, cache limits, lyrics, and theme.

Provider Support

Provider packages currently bundled in the Android app:

- NetEase Cloud Music Package: fuo_netease==1.0.8 Default: Enabled Login modes: WebView, Cookie

- QQ Music Package: fuo-qqmusic==1.0.16 Default: Available in Settings Login modes: WebView, Cookie

- Bilibili Package: feeluown-bilibili==0.5.5 Default: Available in Settings Login modes: WebView, Cookie

- YouTube Music Package: fuo-ytmusic==0.4.18 Default: Available in Settings Login modes: WebView, Headers

The app loads NetEase by default. QQ Music, Bilibili, and YouTube Music are packaged and can be enabled, disabled, or reordered from Settings.

Interface language: Chinese

License

GNU General Public License v3.0

🎯 Project author:github@BruceZhang1993