如何快速搭建个人音乐中心：Supersonic跨平台客户端完整指南 🎵

Supersonic是一款轻量级且功能全面的跨平台桌面客户端，专为自建音乐服务器设计，支持Subsonic/OpenSubsonic API和Jellyfin，让你随时随地享受高品质音乐流媒体体验。本文将带你从安装到进阶使用，轻松打造专属音乐中心！

🚀 为什么选择Supersonic？

在众多音乐客户端中，Supersonic凭借极致轻量化和强大兼容性脱颖而出。它不仅支持Navidrome、Jellyfin等主流自建服务器，还提供原生UI体验和丰富的播放功能，让你的本地音乐库秒变云端流媒体服务！

✨ 核心优势一览

• 跨平台无缝体验：完美支持Linux、Windows和macOS系统
• 高效性能：采用Go语言开发，启动速度快，资源占用低
• 丰富播放控制：15段图形均衡器、Waveform波形进度条、ReplayGain支持
• 多服务器管理：轻松添加多个音乐服务器，支持内外网地址切换

📸 Supersonic界面鉴赏

Supersonic提供精心设计的明暗双主题，满足不同使用场景需求。以下是实际运行界面展示：

正在播放视图

专辑浏览视图

艺术家详情视图

收藏歌曲视图

🎯 支持的音乐服务器

Supersonic兼容所有实现Subsonic/OpenSubsonic API或Jellyfin的音乐服务器，包括但不限于：

• Navidrome：轻量级现代音乐服务器
• Jellyfin：开源媒体中心解决方案
• Gonic：基于Go的简单音乐服务器
• LMS：轻量级音乐服务器
• Nextcloud Music：Nextcloud生态音乐应用
• Airsonic-Advanced：经典音乐服务器升级版

💪 强大功能解析

🔊 高品质音频体验

Supersonic采用MPV作为音频播放引擎，支持 gapless 无缝播放和音频独占模式，配合内置的15段图形均衡器player/mpv/equalizer.go，让你自定义专属音效。

🎛️ 智能播放控制

• 多种播放模式：支持随机播放、单曲循环、列表循环
• 艺术家电台：基于当前艺术家生成相似歌曲混音（需服务器支持）
• DLNA投射：轻松将音乐投射到支持DLNA的设备player/dlna/dlnaplayer.go

📱 系统集成

深度整合系统媒体控制：

• Linux：MPRIS协议支持
• Windows：SMTC系统媒体传输控件
• macOS：媒体中心集成

🎨 个性化主题

内置明暗主题，并支持自定义主题ui/theme/，你可以根据喜好调整界面颜色和布局，打造专属视觉体验。

📥 快速安装指南

Linux系统安装

AppImage（推荐）

1. 访问项目发布页面下载最新AppImage文件
2. 添加执行权限：chmod +x Supersonic-*.AppImage
3. 双击运行或通过终端执行

Debian/Ubuntu系统

1. 安装依赖：sudo apt install libmpv1（或libmpv2）
2. 下载tar.xz包并解压
3. 安装：sudo make install

Flatpak

通过Flathub安装：flatpak install flathub io.github.dweymouth.supersonic

Windows系统安装

直接下载最新安装程序或便携版zip包：

1. 访问发布页面下载.exe安装文件或.zip压缩包
2. 安装版：双击运行安装程序按提示操作
3. 便携版：解压到任意目录，双击supersonic.exe运行

macOS系统安装

Homebrew安装

brew tap supersonic-app/supersonic
brew install --no-quarantine supersonic

手动安装

1. 下载.dmg或.app.zip文件
2. 将Supersonic.app拖入应用程序文件夹
3. 首次运行需解除隔离：xattr -r -d com.apple.quarantine /Applications/Supersonic.app

🔧 从源码构建

如果你想体验最新开发版本，可以从源码构建：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/sup/supersonic
2. 进入项目目录：cd supersonic
3. 根据系统执行构建命令：
   • Linux：make build
   • Windows：在MSYS2终端中执行go build
   • macOS：make build && make package_macos

详细构建指南请参考BUILD.md

🎉 开始使用Supersonic

1. 启动Supersonic应用
2. 首次运行会提示添加服务器
3. 输入服务器地址、用户名和密码
4. 点击"连接"按钮完成设置
5. 开始浏览和播放你的音乐库！

📚 项目结构速览

Supersonic采用清晰的模块化设计：

• 后端核心：backend/ - 包含媒体处理、播放控制和服务器通信
• UI界面：ui/ - 图形界面和用户交互组件
• 播放器：player/ - 不同播放引擎实现
• 资源文件：res/ - 图标、主题和翻译文件

❓ 常见问题

Q: Supersonic支持离线播放吗？
A: 目前正在开发离线模式，敬请期待未来版本。

Q: 如何添加多个音乐服务器？
A: 在设置界面点击"添加服务器"，输入新服务器信息即可，支持无缝切换。

Q: 歌词显示功能如何使用？
A: 播放界面默认显示歌词，若未显示，请确保歌曲有可用歌词或检查服务器设置。

📝 总结

Supersonic为自建音乐服务器提供了一个功能全面、界面友好的桌面客户端解决方案。无论是音乐爱好者还是技术极客，都能通过它轻松管理和享受个人音乐库。立即下载体验，开启你的高品质音乐之旅吧！🎶