Vynody：跨平台本地音乐播放器

项目简介

Vynody 是一款开源的跨平台本地音乐播放器，界面用 Flutter 构建，音频播放则接入各平台原生音频后端，兼顾统一的视觉体验与底层硬件音频能力。作者希望解决各平台本地播放器界面陈旧、资源占用高、跨设备体验割裂的问题，目标是做一个干净、纯粹的听歌工具。

目前已覆盖 Windows、macOS、Linux、iOS 和 Android，并通过应用商店与 GitHub Releases 分发。

主要功能

• 跨平台原生体验：Windows、macOS、Linux、iOS、Android 全覆盖，各平台使用针对性的原生音频引擎。
• Windows WASAPI 独占模式：绕过系统混音器，实现直通、bit-perfect 的音频输出。
• 快速本地曲库与即时索引：智能扫描，毫秒级增量更新，CPU 与内存占用低。
• 音频指纹与标签补全：借助 AcoustID 与 MusicBrainz 识别未知曲目，自动补全元数据和高清封面。
• 完整歌词能力：接入 LRCLIB 即时搜索匹配；支持 AI 生成带精确时间轴的逐字（卡拉 OK）歌词并修正时间线；支持一键多语言翻译与双语显示。
• 无服务器局域网同步：自动发现局域网内的其他实例，传输音乐文件，双向同步歌单、歌词缓存与翻译库，并提供浏览器 Web 界面用于上传下载。
• 远程音乐库：可连接自建的 Navidrome、Jellyfin 服务；也可挂载 WebDAV、SMB 共享，通过按需分块解析文件头，无需下载整首歌即可显示标签。
• 视觉与桌面交互：实时音频频谱、波形、封面色动态提取、多种进度条样式、桌面队列抽屉与全局快捷键。
• 睡眠定时器：倒计时结束后自动停止播放。

音频引擎与技术栈

平台	音频引擎	说明
Windows	Audio Core（Rust）	Rodio + FFmpeg 解码，支持 WASAPI 独占模式
Linux	Audio Core（Rust）	Rodio + FFmpeg 解码
macOS	Audio Core（Rust）	Rodio，优先 AVFoundation 解码，FFmpeg 兜底
iOS	Audio Core（Rust）	Rodio，优先 AVFoundation 解码，FFmpeg 兜底
Android	ExoPlayer (Media3)	深缓冲输出，播放更稳、唤醒更少

其他关键组件：Flutter 3.x + Riverpod 状态管理、SQLite + Drift 本地索引与缓存、UDP 广播发现与内嵌 HTTP 共享服务。

安装与使用

各平台下载渠道：

平台	渠道
Windows	Microsoft Store 或 GitHub Releases
macOS	Mac App Store 或 GitHub Releases
iOS	App Store
Android	GitHub Releases 下载 APK
Linux	GitHub Releases（deb / AppImage / rpm / tar.gz）

从源码构建需要 Flutter SDK 3.x、Rust 工具链（含 cargo）以及目标平台的原生构建工具链（Xcode / Visual Studio / Android SDK & NDK）：

git clone --recurse-submodules https://github.com/axel10/vynody
cd vynody
flutter pub get
flutter run -d <device-id>

如果克隆时漏掉了 --recurse-submodules，构建前先执行 git submodule update --init。

注意事项

• 项目采用 GPL-3.0 许可证，GitHub Releases 中的安装包免费提供。
• 部分功能依赖第三方服务或自建服务，例如 LRCLIB 歌词、Navidrome / Jellyfin 服务器、WebDAV / SMB 共享，以及可配置的 AI 模型（用于歌词生成与翻译）。
• 开发过程采用 AI 辅助的 Vibe Coding 工作流，并经过多轮真机测试。
• 提交代码前请确保 flutter test 通过。

---

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