Sylvakru（森露）：跨平台音乐播放器

项目简介

Sylvakru（森露）是一款使用 Flutter 构建的跨平台音乐播放器，原名 Particle Music，可运行在 Android、iOS、Windows、Linux 和 macOS 上。它的定位是「数字世界里的私人音乐绿洲」：既可以直接播放设备上的本地音乐，也能连接自建的媒体服务，把分散的音乐统一到一个播放器里管理。

主要功能

• 多种音乐来源：本地、WebDAV、Navidrome、Emby，以及飞牛音乐（Feiniu Music）。
• 广泛的格式与标签支持：

文件格式	元数据格式
AAC (ADTS)	ID3v2、ID3v1
Ape	APE、ID3v2*、ID3v1
AIFF	ID3v2、Text Chunks
FLAC	Vorbis Comments、ID3v2*
MP3	ID3v2、ID3v1、APE
MP4	iTunes-style ilst
MPC	APE、ID3v2、ID3v1
Opus / Ogg Vorbis / Speex	Vorbis Comments
WAV	ID3v2、RIFF INFO
WavPack	APE、ID3v1

* 由于缺乏官方支持，这类标签为只读。

• 音频处理组件：audio_tags_lofty 负责读写音频标签（基于 lofty），media_kit 负责音频播放（基于 mpv/FFmpeg）。
• 界面适配：提供手机与桌面两套界面，iPhone、iPad 和桌面端均有适配截图。

安装与使用

项目为 Flutter 应用，需先参照 Flutter 官方安装指南 装好 Flutter 环境，再克隆仓库运行。

git clone https://github.com/AfalpHy/sylvakru.git
cd sylvakru
flutter doctor -v
# 调试模式运行
flutter run
# 发布模式运行
flutter run --release

Ubuntu / Debian 需要先安装依赖：

sudo apt install clang lld cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libsecret-1-dev
sudo apt install libmpv-dev
flutter build linux
# 生成 .deb 包
flutter build linux && ./generate_deb.sh

Windows 需先安装 Visual Studio，然后执行 flutter build windows。

macOS / iOS 需安装 Xcode 与命令行工具，并用 brew install cocoapods 安装 CocoaPods，之后执行 flutter build macos；iOS 可构建未签名 ipa：

flutter build ios --release --no-codesign && \
mkdir -p Payload && \
cp -r build/ios/iphoneos/Runner.app Payload/ && \
zip -r sylvakru.ipa Payload && \
rm -rf Payload

Android 需安装 Android Studio 与 Android SDK 命令行工具：

flutter doctor --android-licenses
flutter build apk
# 按 ABI 拆分
flutter build apk --split-per-abi
# 构建 TV 版本
flutter build apk --dart-define=TV=true

注意事项

• iOS 版本已在 Apple App Store 上架。
• Android 的 USB 独占模式由 huya688zdx 维护，需要使用该 fork。
• 项目使用 Apache-2.0 许可证。

---

本作品整理自 GitHub 开源项目 AfalpHy/sylvakru，原作者 @AfalpHy，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。