YMusic：跨平台开源音乐播放器

项目简介

YMusic 是一个用 Kotlin Multiplatform 编写的开源音乐播放器，可运行在 Android、桌面端（macOS、Windows、Linux）以及 iOS / iPad 上。项目主页为 ymusic.io，源码托管在 GitHub，采用 GPL-3.0 许可证。

从功能与更新说明来看，它围绕 YouTube 的视频、播放列表、频道与专辑来组织音乐内容，并提供队列、正在播放、视频详情、音乐库与歌单等界面。

主要功能

• 多平台：同一套 Kotlin 代码覆盖 Android、iOS/iPad 与桌面系统。
• 音乐库与播放队列：音乐库、音乐库搜索、播放队列、正在播放页、视频详情页与歌单页面。
• 歌曲菜单：在各列表中提供跳转艺人、跳转专辑、加入播放列表等操作。
• 链接分享：在 Android 与 iOS 上通过系统分享面板分享 YouTube 视频、播放列表、频道和专辑的链接，入口包括列表行、队列、正在播放、视频详情与歌单页面。

安装与使用

官方发布的安装包只从 ymusic.io 或 GitHub Releases 获取。

从源码构建需要 JDK 17+、Node.js、CMake 与 C 工具链（用于 QuickJS 原生库）；构建 Android 应用还需要 Android SDK，构建 iOS 应用需要 Xcode（macOS）。

FFmpeg 来自 ffmpeg-build，需要检出到本仓库同级目录 ../ffmpeg-build 并在本地编译，不会自动下载：

git clone --recursive --shallow-submodules https://github.com/ymusic-io/ffmpeg-build ../ffmpeg-build

先在该目录编译所需目标：桌面端用 scripts/build-desktop.sh，Android 用 scripts/build-android.sh <abi>（支持 armeabi-v7a、arm64-v8a、x86、x86_64），iOS 用 scripts/build-ios.sh。

然后运行：

# 桌面端
./gradlew :desktopApp:run

# Android
./gradlew :androidApp:installDebug

iOS 应用在 Xcode 中打开 iosApp/iosApp.xcodeproj 构建，其 Kotlin framework 由 :iosAppKotlin 自动提供。

注意事项

• 请只从可信来源安装 YMusic：官网 ymusic.io 或 GitHub Releases。任何人都可以编译修改过的副本，恶意版本可能在你登录时窃取 Google 账号凭据。
• 作者不对应用的任何滥用行为负责。
• 许可证：整体为 GPL-3.0；kmpCommon/ 与 kmpHttp/ 两个基础库单独采用 Apache-2.0，且不得依赖 GPL 模块。

本作品整理自 GitHub 开源项目 ymusic-io/YMusicV4，原作者 @ymusic-io，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。