404 ·GitHub
What is this?
Beans Music is an open-source SwiftUI music player for iOS 15+ that lets you browse, search, and play tracks from NetEase Cloud Music, QQ Music, and Kugou Music in one native app, alongside local playlists, lyrics, and offline files.
Beans Music is an open-source SwiftUI music player for iOS 15+ that lets you browse, search, and play tracks from NetEase Cloud Music, QQ Music, and Kugou Music in one native app, alongside local playlists, lyrics, and offline files.How do I build and run it?Clone the repo on a Mac, run XcodeGen to generate the Xcode project, then build it in Xcode 26 or later; there's no prebuilt signed app to just install.
Clone the repo on a Mac, run XcodeGen to generate the Xcode project, then build it in Xcode 26 or later; there's no prebuilt signed app to just install.What do I need before I can build this?A Mac with macOS, Xcode 26 or later, and XcodeGen installed; it's build-from-source only, no package manager install.
A Mac with macOS, Xcode 26 or later, and XcodeGen installed; it's build-from-source only, no package manager install.What devices does it run on?It's an iOS-only native app requiring iOS 15 or later; there's no Android, macOS, or web version.
It's an iOS-only native app requiring iOS 15 or later; there's no Android, macOS, or web version.Do I need my own accounts for NetEase, QQ Music, and Kugou?Yes - you log in with your own accounts for those platforms, and any music sources you configure are stored only on your device, not bundled in the repository.
Yes - you log in with your own accounts for those platforms, and any music sources you configure are stored only on your device, not bundled in the repository.What does the Liquid Glass styling do?On supported systems the player UI picks up Apple's Liquid Glass visual style, with multiple layouts, themes, and wallpapers you can configure.
On supported systems the player UI picks up Apple's Liquid Glass visual style, with multiple layouts, themes, and wallpapers you can configure.What playback features does it have?Shuffle, repeat, adjustable playback speed, sleep timer, background playback, and lock-screen controls, plus lyrics with translation and interactive scrolling/seeking.
Shuffle, repeat, adjustable playback speed, sleep timer, background playback, and lock-screen controls, plus lyrics with translation and interactive scrolling/seeking.Can I listen offline with my own files?Yes - besides the three streaming platforms, it supports local playlists, offline downloaded files, and importable music sources with native share/export.
Yes - besides the three streaming platforms, it supports local playlists, offline downloaded files, and importable music sources with native share/export.Why does the README say it's for study only?Because it pulls content from third-party Chinese music platforms without an official partnership, the author frames it as a learning project and asks users to respect each platform's terms of service.
Because it pulls content from third-party Chinese music platforms without an official partnership, the author frames it as a learning project and asks users to respect each platform's terms of service.What are similar projects?kumone, placard, Mineradio-paused, vivi-music, openspot-music-app, DiPlay-CN, Omarchy-Spotify, Echo-Music
kumone, placard, Mineradio-paused, vivi-music, openspot-music-app, DiPlay-CN, Omarchy-Spotify, Echo-MusicWhich topics is it in?download, music-player, ios-app, localization, swiftui, music, theme, app, i18n, audio, mobile-app, streaming
download, music-player, ios-app, localization, swiftui, music, theme, app, i18n, audio, mobile-app, streaming