Beans-Music README

The project's README from github.com/XIaodou0416/Beans-Music. As one markdown file: README.md.

Beans Music

Beans Music is an open-source SwiftUI music player for iOS 15 and later. It brings several music platforms, local playlists, lyrics, downloads, and a highly configurable player into one native app.

This repository contains the public iOS client.

Highlights

Project Layout

Beans/
  BeansApp.swift              Application entry point
  RootView.swift              Tab navigation and mini player
  DiscoverView.swift          Home, recommendations, and rankings
  SearchView.swift            Platform search and result navigation
  LibraryView.swift           Synced and local music libraries
  ProfileView.swift           Account, appearance, backup, and settings
  PlayerView.swift            Full player and lyrics experience
  PlayerManager.swift         Queue, playback, history, and recovery
  NetEaseAPI.swift            NetEase integration
  QQMusicAPI.swift            QQ Music integration
  KugouMusicAPI.swift         Kugou integration
  UnblockService.swift        User-configured source resolution
  DownloadManager.swift       Audio download and export
  Theme.swift                 Theme and wallpaper state
  Models.swift                Shared models and enums

Build

Requirements:

Generate the project and build an unsigned app:

brew install xcodegen
xcodegen generate
xcodebuild \
  -project Beans.xcodeproj \
  -scheme Beans \
  -configuration Release \
  -sdk iphoneos \
  -derivedDataPath build \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGN_IDENTITY="" \
  build

The GitHub Actions workflow can build an unsigned IPA on demand. The workflow is configured for test builds by default and does not create a release unless explicitly enabled.

Development Notes

License

This project is distributed under the MIT License. See LICENSE.

Music, trademarks, and platform services belong to their respective owners. Use the app responsibly and follow each platform's terms of service.

Beans-Music (XIaodou0416/Beans-Music)

Searching Database…

这是什么?Beans Music 是一个面向 iOS 15+ 的开源 SwiftUI 音乐播放器,让你在一个原生应用里浏览、搜索并播放 NetEase Cloud Music、QQ Music 和 Kugou Music 的歌曲,同时支持本地播放列表、歌词和离线文件。
我怎么构建并运行它?在 Mac 上克隆仓库,运行 XcodeGen 生成 Xcode 工程,然后在 Xcode 26 或更高版本中构建;没有可直接安装的预构建签名应用。
构建之前我需要准备什么?一台装有 macOS 的 Mac、Xcode 26 或更高版本,以及已安装的 XcodeGen;它只能从源码构建,没有包管理器安装方式。
它运行在什么设备上?它是一个仅限 iOS 的原生应用,要求 iOS 15 或更高版本;没有 Android、macOS 或网页版。
我需要自己的 NetEase、QQ Music 和 Kugou 账户吗?需要——你要用自己在这些平台的账户登录,你配置的任何音乐源都只保存在你的设备上,不会打包进仓库。
液态玻璃(Liquid Glass)样式是什么效果?在受支持的系统上,播放器 UI 会采用 Apple 的液态玻璃视觉风格,并提供多种可以配置的布局、主题和壁纸。
它有哪些播放功能?随机播放、循环播放、可调播放速度、睡眠定时器、后台播放和锁屏控制,此外还有带翻译的歌词以及可交互的滚动/拖动进度。
我能用自己的文件离线听歌吗?可以——除了那三个流媒体平台,它还支持本地播放列表、离线下载的文件,以及可导入的音乐源,并带有原生的分享/导出功能。
为什么 README 说它仅供学习?因为它在没有官方合作的情况下从第三方中文音乐平台拉取内容,作者把它定位为一个学习项目,并请用户尊重各平台的服务条款。
Size
200.7 MB
Stars
411
Age
1mo
Commits · 90 Days