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 — опенсорсный музыкальный плеер на SwiftUI для iOS 15+, позволяющий просматривать, искать и проигрывать треки из NetEase Cloud Music, QQ Music и Kugou Music в одном нативном приложении, а также работать с локальными плейлистами, текстами песен и офлайн-файлами.
Как его собрать и запустить?Склонируйте репозиторий на Mac, запустите XcodeGen для генерации Xcode-проекта, затем соберите в Xcode 26 или новее; готового подписанного приложения для простой установки нет.
Что нужно, чтобы собрать это?Mac с macOS, Xcode 26 или новее и установленный XcodeGen; сборка только из исходников, без установки через менеджер пакетов.
На каких устройствах он работает?Это нативное приложение только для iOS, требующее iOS 15 или новее; версий для Android, macOS или веба нет.
Нужны ли свои аккаунты для NetEase, QQ Music и Kugou?Да — вы входите в свои аккаунты этих платформ, а любые настроенные музыкальные источники хранятся только на вашем устройстве, а не в комплекте репозитория.
Что даёт оформление Liquid Glass?На поддерживаемых системах UI плеера подхватывает визуальный стиль Apple Liquid Glass, с несколькими макетами, темами и обоями, которые можно настроить.
Какие функции воспроизведения у него есть?Перемешивание, повтор, регулируемая скорость воспроизведения, таймер сна, фоновое воспроизведение и управление с экрана блокировки, плюс тексты песен с переводом и интерактивной прокруткой/перемоткой.
Можно ли слушать офлайн со своими файлами?Да — помимо трёх стриминговых платформ, поддерживаются локальные плейлисты, скачанные офлайн-файлы и импортируемые музыкальные источники с нативным шерингом/экспортом.
Почему в README сказано, что это только для учёбы?Поскольку он берёт контент с китайских сторонних музыкальных платформ без официального партнёрства, автор подаёт его как учебный проект и просит пользователей уважать условия использования каждой платформы.
Size
200.7 MB
Stars
411
Age
1mo
Commits · 90 Days