Astra：发烧友本地音乐播放器

项目简介

Astra 是一款桌面音乐播放器，专门为仍然保存本地音乐库的人设计。它播放你硬盘里的 FLAC、MP3 等文件，内置原生 C++ DSP 引擎，提供实时可视化、参数均衡器、Dolby Atmos 解码、多房间同步播放和 scrobbling。没有遥测、没有账号、没有流媒体。

主要功能

播放

• 无缝播放（gapless）配合预缓冲，专辑可以按原本的编排连续播放。
• 原生支持 MP3、FLAC、WAV、OGG、AAC、M4A、OPUS、WMA、AIFF、ALAC、APE、WavPack，其他格式走 FFmpeg 回退。
• Bit-perfect 输出可绕过系统混音器直接送达硬件：Windows 上是 WASAPI Exclusive，macOS 上是 CoreAudio HAL，Linux 上是 ALSA hw。

空间音频

• 支持原生 IAMF / Eclipsa Audio 播放，这类音轨在资料库中可识别、搜索、加入队列并显示渲染后的声道布局。
• 通过 Astra Spatial Engine 在本地解码与渲染：基于声道或基于场景的内容可以双耳渲染给耳机、直接输出到多声道硬件，或适配当前输出布局，无需 Eclipsa 认证硬件。
• 支持 Dolby Atmos 多声道解码，同样不要求 Atmos 兼容硬件。
• 提供逐声道检查与重映射、输出延迟校准，以及可在 3D 空间中拖动虚拟音箱的 Virtual Speaker Room。

Parallax 多机同步

在局域网内让多台机器同步播放同一份音乐：一台主机负责托管与控制，其他机器作为扬声器加入，通过 PIN 配对，可对每个扬声器单独调延迟。仅在本地网络运行，需要到设置的 Experimental 区域手动开启。

可视化器

七个由原生 C++ 模块驱动的实时可视化器（示波器、频谱分析仪、矢量示波器等），可自由拖拽、缩放、保存布局预设。分析链路独立于输出路由，示波器始终反映源素材。

均衡器

最多 20 段全参数均衡，带频谱叠加的实时频响曲线与内置预设，可保存自定义预设，也能直接导入 AutoEQ 耳机校准配置。

资料库

指向音乐文件夹后自动完成元数据提取与封面处理，可按艺人、专辑、曲目浏览与搜索。读取 ID3v2.4 与 Vorbis Comments，能解析多艺人标签，支持自定义艺人图片，并按文件名扫描 .lrc 歌词。收藏与最近播放自动记录，内置元数据编辑器可直接修标签。

Astra Resolve 用于处理“所有表演者塞进一个 Artist 字段”的情况：它借助资料库中的单艺人署名、结构化多艺人标签和重复命名模式判断艺人的分界，让 Tyler, the Creator、Earth, Wind & Fire 这类名字保持完整，同时让合作艺人获得独立链接；也用封面、日期和曲目编号把 Album Artist 缺失的专辑归到一起。全部本地完成，不改写文件、不查询外部元数据。

界面

进度条渲染当前曲目的真实波形，全屏模式显示专辑封面与环境频谱背景。

迷你播放器在不想占用屏幕时保留控制入口。

支持同步歌词与自动滚动，来源包括内嵌歌词、.lrc 文件或 LRCLIB，歌词面板可弹出为独立窗口。

音频设置与集成

• 输出设备选择、ReplayGain 响度归一化、多声道逐声道重映射、无线或蓝牙音箱的延迟校准。
• 内置 Last.fm、AudioScrobbler、ListenBrainz 支持，也可自定义 scrobbler 端点，并支持同时提交到多个服务。
• Discord Rich Presence；可连接 Jellyfin 以及任意 Subsonic 兼容服务器（Navidrome、Airsonic、Gonic、Funkwhale 等）。
• 可选的 Astra API 供外部工具观察与控制播放、进行有限范围的资料库搜索、编辑播放队列与维护收藏，默认关闭并使用 bearer 认证。

实验性功能

手机端 PWA 控制器（局域网内控制播放，支持系统媒体控制与二维码配对）、资料库完整性扫描、艺人不连关系图可视化、立体声上混到多声道、5×5 网格活动指示器，以及 Xbox / PlayStation 手柄导航。

安装与使用

Windows、macOS、Linux 的预编译版本可在 Releases 页面下载。

Windows 用户可以：

winget install Boof2015.Astra

Arch Linux 上官方提供 astra-music-bin（AUR）。

从源码构建需要 Node.js 18+、npm 和 C++ 编译器工具链（macOS：Xcode Command Line Tools；Windows：Visual Studio Build Tools；Linux：build-essential、python3、libasound2-dev）：

For more details, see the [Native Module documentation](https://github.com/Boof2015/astra/blob/dev/docs/native-module.md).
npm install

postinstall 脚本会为当前平台编译原生 C++ 可视化模块。常用脚本：

npm run dev              # 开发
npm run build            # 构建应用资源
npm run dist             # 为当前平台打包
npm run dist:mac         # macOS（DMG + ZIP）
npm run dist:win         # Windows（NSIS + Portable）
npm run dist:linux       # Linux（AppImage + DEB + RPM + tarball）

注意事项

• 所有涉及网络的功能都是可选且默认关闭的。
• Parallax 与上文的实验性功能仍在演进，可能根据反馈调整或移除。
• 社区维护的打包（如社区版 AUR 包、TerraPKG）由第三方构建、签名与分发，项目本身不提供官方支持。
• 项目使用 GNU General Public License v3.0 许可。

---

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