FuoEvolve

中文 | English

FuoEvolve is an open-source, cross-platform music player built around the FeelUOwn ecosystem. It brings online music services, local music, lyrics, downloads, and video into one modern app.

Download

Platform	Stable	Canary / Preview
Android	GitHub Release · F-Droid repository	Latest master build
Windows x64	—	MSI / EXE from Master Canary
macOS arm64 / x64	—	DMG / PKG from Master Canary
Linux x64	—	AppImage / DEB / RPM / Arch package from Master Canary
iOS	—	Experimental development builds only

Desktop Canary packages are preview builds. Windows and macOS packages are not yet production-signed/notarized.

Features

• 🎵 Multiple music sources — use NetEase Cloud Music, QQ Music, Bilibili, and YouTube Music in one app.
• 🧭 Discover and search — browse recommendations, charts, playlists, artists, albums, videos, and search across enabled sources.
• ▶️ Music and video playback — queue management, shuffle/repeat, seeking, sleep timer, MV/video playback, and multipart Bilibili content.
• 🎤 Rich lyrics — synchronized lyrics, translations, romanization, word-level timing where available, plus manual lyric matching.
• 🔁 Smart source replacement — automatically look for a suitable alternative when the current track cannot be played.
• 💽 Local and offline music — scan local files, edit metadata, create local playlists, download supported tracks, and resume interrupted downloads.
• ❤️ Library management — manage favorites, playlists, albums, and artists where the music service supports it.
• 🎙️ Audio recognition — identify nearby music and jump directly to search or song details.
• 🔐 Portable account credentials — securely store provider logins and move supported credentials between devices when needed.
• 🎨 Material 3 Expressive UI — adaptive layouts, light/dark themes, dynamic color, and cover-inspired player colors.

Desktop

The desktop app shares the same experience as mobile and is available for Windows, macOS, and Linux.

• Windows: system media controls through SMTC.
• macOS: Now Playing / Remote Command Center integration.
• Linux: MPRIS media controls; native Wayland is the target, with packaging validation still in progress.
• Tray lifecycle: closing the window keeps playback and downloads running; the tray/status item can restore or exit the app.
• Secure login storage: Windows Credential Manager, macOS Keychain, and Linux Secret Service/Libsecret.

Desktop packages currently ship through the Canary workflow while release signing and final distribution are still being completed.

Music Sources

Source	Main content
NetEase Cloud Music	Recommendations, private FM, charts, playlists, artists, albums, MV, favorites, and cloud music
QQ Music	Recommendations, private FM, charts, playlists, artists, albums, MV, favorites, and library content
Bilibili	Music/video search, recommendations, followed creators, favorites, history, watch later, and multipart video
YouTube Music	Search, recommendations, library, playlists, artists, albums, radio, lyrics, and video

Available content depends on the source, region, login state, and upstream service behavior. Sources can be enabled, disabled, reordered, and signed in from Settings.

Platform Status

Platform	Status	Notes
Android	Stable	Primary release platform
Windows	Canary	Installable x64 desktop packages
macOS	Canary	Apple Silicon and Intel packages
Linux	Canary	Native Wayland target; AppImage and distribution packages
iOS	Experimental	Development and CI validation only

Development

FuoEvolve uses Compose Multiplatform across supported platforms.

# Android debug build
./gradlew :androidApp:assembleDebug

# Run the desktop app
./gradlew :desktopApp:run

Desktop development also requires a Rust/Cargo toolchain and the native dependencies for the target platform. See docs/desktop-foundation.md and docs/desktop-packaging.md for setup and packaging prerequisites.

Contributing

Bug reports, feature discussions, and pull requests are welcome. See Issues and Pull Requests.

License

FuoEvolve is licensed under the GNU General Public License v3.0.