为本地音乐而生的桌面播放器
专注曲库管理、稳定播放、HiFi 输出与长期使用体验
觉得 ECHO 还不错？给它点个 ★ Star 吧，我们会开心很久。
English · 官方网站 · 下载 ECHO NEXT · 使用文档 · 更新日志 · 问题反馈
前段时间，我们曾迫不得已将 ECHO 闭源。
在此之前，项目维护者遭到某位用户持续数月的辱骂与精神压迫，仓库也曾两次遭到破坏（感谢某位contributor毁坏两次仓库喵~）如果Github能删这个就好了。与此同时，甚至有人指责我们开源是为了“骗钱”。（尊贵的“柠檬起司”大人甚至试图破解开源软件。。真是低调的黑客...好害怕）这些事情让我们非常心寒，也让原本单纯的开源与分享变成了沉重的负担，因此我们一度选择关闭源码，保护项目和维护者。
但现在，我们改变主意了。
我们仍然相信开源、分享和社区的价值，也不希望少数人的恶意让所有真正喜欢 ECHO、愿意使用和共同建设它的人失去参与的机会。因此，ECHO 将重新面向大家开源。源码、开发文档和贡献方式会逐步整理并恢复到公开仓库。
欢迎开发者参考、学习和借鉴 ECHO 的设计思路与实现。参考了 ECHO 的代码或设计，给项目留个名字或链接就好~ 这点小小的尊重会让开源社区更舒服。具体使用、复制和分发仍请遵守仓库中的许可证。
同时请注意：任何大型 PR 都不会被合并。 如果你希望参与贡献，请先通过 Issue 沟通，并将改动拆分成范围清晰、容易审查和验证的小型 PR。
感谢每一位善意使用、认真反馈、帮助测试和参与贡献的朋友。希望这一次，我们可以一起让 ECHO 走得更远。
ECHO 要上架 Steam 啦！不过上架Steam也意味着砍掉流媒体沦为纯本地播放器 虽然说我们的重心会转向 steam 版本，该仓库发布的版本转为社区版，由大家共同维护，但是如果有任何严重问题的话，我们依旧会提供永久更新
届时 steam 版本会支持 Linux 和 macOS 综合为了回本（圈钱）以及ECHO的生态（个人的梦想就是打造强生态 也就是创意工坊）遂打算上架Steam!
在 2026 年 8 月 15 日前购入 ECHO Pro，可享受以下权益：
- 免费获得 Steam CD Key；
- 加入 ECHO 贡献者名单；
- 支付邮费即可获赠 ECHO 周边。
购买地址：爱发电 ECHO NEXT
大家想要什么功能，也欢迎填写 ECHO 许愿池，告诉我们你的想法。
ECHO是功能最全面的音乐播放器、（自信）
（如果有比我还全的 我要做高调的黑客了。）
「ECHO NEXT」の NEXT は、Ado の楽曲『新時代』から取りました。
它不只是给旧 ECHO 加一个新名字。老版本在大曲库、长时间运行和功能不断叠加时，确实暴露过严重的性能问题：播放、界面、扫描和状态更新互相牵扯，代码也越堆越像一座不太好下脚的山。说得直白一点，老 ECHO 有性能问题，也有屎山问题(虽然NEXT也有很多屎山。但比老版本强一千倍)。
NEXT 是一次把基础重新理顺的尝试：保留喜欢的功能，也把性能、稳定性、模块边界和原生播放链路当成真正的产品能力，而不是以后再说的 TODO。
| LOCAL LIBRARY | DSP CENTER | NATIVE OUTPUT |
|---|---|---|
| 文件夹扫描、SQLite 曲库、标签、封面、专辑墙与播放列表 | 参数 EQ、Headroom、FIR、OPRA、声道工具与输出安全 | WASAPI Shared / Exclusive、ASIO、DSD / DoP 与 HQPlayer |
Note
源码已经公开；许可证和第三方材料以仓库当前文件为准。
ECHO 不把整条音频链路塞进一个“音质增强”按钮。输入、处理模块、采样率、输出模式、设备状态和回退原因都该看得见。
本地文件播放走 host-centered 的原生数据面：文件读取、libav 解码、ECHO SRC、Dither、SDM、FIFO、设备输出和 drain 判定由 echo-audio-host 持有；Electron 主进程负责输出计划、控制命令和状态解释，界面只负责展示与操作。播放位置以原生输出 frame counter 为准，解码器读完文件不等于歌曲已经播放结束。
LOCAL FILE
|
libav decode in echo-audio-host
|
PCM -> ReplayGain / Headroom / EQ / FIR / Channel Tools
|
ECHO SRC / Dither / ECHO SDM when explicitly enabled
|
native FIFO, output clock and drain detection
|
WASAPI Shared / Exclusive / ASIO / HQPlayer
|
DAC
处理可以逐层打开，也可以全关。想调音时，ECHO 会告诉你声音经过了什么；想直出时，就把它们旁路。远程 URL、CUE、带特殊 headers 的请求和部分 gapless / automix chained playback 仍走兼容路径；不能用原生 DSP 时会直接说，绝不装作已经生效。
echo-audio-host 会常驻接手本地文件读取、libav 解码、预取、FIFO、DSP、设备输出和播放收尾；主进程通过 JSON-RPC 发出明确的打开、播放、暂停、seek、停止和队列命令，界面只负责控制和显示。
这样做最实际的好处是：扫封面、写数据库、React 重渲染，甚至主进程偶尔忙一下，都不该把正在播放的 PCM 一起拖住。输出时钟、缓冲尾部和 ended 都由 host 说了算，自动下一首不用再靠前端猜时间。
echo-native-scanner 是随应用打包的 C++ Scanner，负责目录扫描和音频元数据读取，再把结果以结构化数据交回曲库；扫描、重扫、基准和 smoke 都有独立入口。
它的意义不只是“更快”三个字：导入几万首歌时，界面不必替重 I/O 和格式探测硬抗。现有兼容路径仍在，遇到不适用的格式或环境会回退或报出原因；
ECHO 不是浏览器播放器，也不是网页端套个窗口。Electron 是我们的桌面壳和前端运行时：React 的组件化、可视化、热更新、跨平台窗口和迭代速度，都让播放器界面可以认真做。
真正吃重的部分已经不在网页里：音频 daemon、native scanner、WASAPI / ASIO、DSD、DSP 和系统集成各做各的事。用 Electron 不是杀人；不要在说为什么不用Tauri了，它给前端带来的收益很大，对个人开发者很有帮助。此外，轻量化并不是我们的主要路线。
DSP Center 把常常要一起用的 EQ、余量、耳机校正、FIR 和声道工具放在一个地方，想开就开，想关就关。
| 模块 | 能力 |
|---|---|
| Parametric EQ | Simple 模式快速塑造 Bass、Vocal、Air、Warm；Pro 模式保留频率、增益、Q 值与 Preamp 精调 |
| Headroom / Output Safety | Auto Gain、前级余量、削波风险和输出安全状态进入同一套工作流 |
| OPRA Headphone Correction | 按品牌和型号选择耳机校正曲线，并保留 A/B 与旁路判断 |
| FIR / Room Correction | 导入 IR，管理 Trim、延迟和卷积处理前后的安全余量 |
| Channel Tools | 左右声道增益、平衡、延迟差、Mono 与声道交换 |
| APO Import / Export | 连接已有 Equalizer APO 配置与 ECHO 的 DSP 工作流 |
EQ、FIR、ReplayGain、声道工具和重采样只要参与处理，就不再算 bit-perfect。把它们全旁路后，且输出格式没有别的问题，状态才会回来。开着 DSP 还自称直通，没这个选项。
ECHO SRC 是 PCM 采样率转换链路。它按 44.1 kHz 和 48 kHz 两个家族规划目标，不会把所有歌硬塞进同一个输出格式。
PCM INPUT
|
ECHO FIR / SAMPLE RATE CONVERSION
|
2x PCM / 4x PCM / 8x Ultra
|
WASAPI EXCLUSIVE or OFFICIAL ASIO
|
DAC
| 维度 | ECHO SRC |
|---|---|
| 倍率 | 2x PCM、4x PCM、8x Ultra；源采样率已经达到目标时可以旁路 |
| 质量策略 | Balanced、Transparent、Low latency |
| 滤波与精度 | 普通模式提供可靠起点，高级模式开放 Filter、Quality Ladder、Dither 与 Noise Shaping |
| 计算路径 | 本地原生播放由 native CPU 路径执行；CUDA worker 还在，但不会把 CPU fallback 冒充成 CUDA 已启用 |
| 状态反馈 | 显示源采样率、目标采样率、引擎、质量策略、精度与当前路径 |
| 输出要求 | 验证升频时使用 WASAPI Exclusive 或 DAC 厂商官方 ASIO，并由真实 DAC 状态确认结果 |
升频会重算 PCM 采样点，所以不是 bit-perfect。它不会凭空造出细节，倍率也不是越高越好；算法、驱动、DAC 和整条链路能不能稳定才更重要。
Note
ECHO SDM 当前属于研发预览。它是独立于 PCM 升频和原生 DSD 直出的实验链路，不应被理解为所有设备上默认可用的正式能力。
ECHO SDM 探索的是从 PCM 到 Sigma-Delta Modulation 的完整处理路径：
PCM INPUT
|
OVERSAMPLING / FIR
|
SIGMA-DELTA MODULATION
|
NOISE SHAPING
|
DSD / SDM OUTPUT FOR A SUPPORTED DAC
它把过采样、滤波、调制和噪声整形串在一起；本地 direct path 的调制与输出路由都在 native host 内完成，目前以 CPU 路径为准。先把普通 PCM 播稳，再碰这条链路。设备或驱动不满足条件时，它会回到 PCM，并告诉你为什么。
| 路径 | 输入 | 发生了什么 | 输出目标 |
|---|---|---|---|
| Native PCM | PCM | 不启用额外 DSP 时尽量保持直接输出 | PCM DAC path |
| ECHO SRC | PCM | FIR 与采样率转换，生成新的 PCM 采样点 | 更高采样率 PCM |
| ECHO SDM | PCM | 过采样、滤波、Sigma-Delta 调制与噪声整形 | 支持设备上的 DSD / SDM，研发预览 |
| DSD Direct | DSF / DFF | 通过 DoP 封装或厂商官方 ASIO Native DSD 传输 | DAC 的 DSD 接收路径 |
ECHO NEXT 会把这四条路径分开表达。PCM 升频不冒充 DSD，PCM→SDM 不冒充原生 DSD 文件直出，界面显示 ASIO 也不等于 DAC 一定收到了 Native DSD。
| 输出方式 | 适合场景 | 边界 |
|---|---|---|
| System / WASAPI Shared | 日常稳定播放、蓝牙、系统混音与快速排障 | 最兼容，但最终格式可能由系统混音器决定 |
| WASAPI Exclusive | 绕开共享混音、按曲目或 DSP 目标打开 DAC | 设备会被独占，更依赖驱动和 DAC 能力 |
| ASIO | 厂商官方驱动、专业声卡、低延迟与 Native DSD 场景 | 不把 ASIO4ALL 等包装层等同于厂商原生能力 |
| DSD over PCM | 让支持 DoP 的 DAC 从 PCM 外观帧中还原 DSD | 链路不能对承载数据做音量、混音或重采样 |
| ASIO Native DSD | 向明确支持的 DAC 传递原生 DSD | 属于实验能力，需要厂商官方驱动与严格音量安全 |
| HQPlayer | 将曲库和播放控制交给 ECHO，高阶滤波与调制交给专用引擎 | 实际能力取决于 HQPlayer、NAA、DAC 与网络链路 |
DSD 播放时，数字音量、EQ、ReplayGain 和普通 PCM DSP 会破坏直出目标。ECHO 因此强调满刻度数字音量、DAC 或前级控制实际响度、官方驱动、真实设备指示和明确回退，而不是只看软件里有没有“DSD”三个字。
阅读 DSD 播放教程 · 比较 WASAPI Exclusive 与 ASIO
| 能力层 | 功能范围 |
|---|---|
| 本地曲库 | 文件夹导入、SQLite 曲库、标签读取、封面缓存、专辑、艺术家、收藏、历史、播放列表与重复歌曲筛选 |
| 歌词与 MV | 本地与在线候选、翻译、罗马音、歌词偏移、桌面歌词、沉浸播放页与 MV 匹配 |
| 远程来源 | WebDAV、SMB、Jellyfin、Emby、Subsonic、Navidrome 与受控的远程索引和播放 |
| 插件扩展 | 插件、下载器、网络元数据与后台任务运行在清晰的权限和诊断边界内 |
| 长期维护 | 日志、崩溃恢复、曲库健康、缓存迁移、设置备份和危险操作确认 |
| 你想要…… | 前往 |
|---|---|
| 获取最新稳定版本 | 官方下载页 · GitHub Releases |
| 第一次使用 ECHO NEXT | 使用文档 |
| 了解最近发生了什么 | 更新日志 |
| 报告问题或提出建议 | GitHub Issues |
| 支持项目长期开发 | ECHO Pro |
| 提交你期待的新功能 | ECHO 许愿池 |
| 参与安卓开发 | ECHO Android |
接下来会继续收拾曲库扫描、播放稳定性、设备兼容、歌词/MV 和桌面细节，也会继续填插件、远程来源和 Connect 的坑。没有把它们写成“宏大路线图”，因为很多事情要等真实设备和真实曲库来打脸；进度以更新日志和发布说明为准。
ECHO Pro 是给愿意长期支持 ECHO 的朋友准备的。收到的支持会用在基础设施、测试设备、设计和持续开发上。
权益和实验功能会随版本调整，具体以官方页面为准。
████████████████████████████████████████
ECHO Android 是 ECHO 的 Android 客户端项目。想参与移动端播放器、曲库、同步、播放体验或平台适配开发，可以直接前往仓库了解进展并提交 Issue 或 PR。
如果你遇到异常，请先确认正在使用最新版本，再通过 GitHub Issues 提交反馈。信息越完整，问题通常越容易被定位：
- ECHO NEXT 版本与下载渠道；
- 操作系统版本和设备信息；
- 清晰、可重复的操作步骤；
- 预期结果与实际结果；
- 必要的截图、日志或录屏。
提交前请移除账号、令牌、本机隐私路径和其他敏感信息。功能建议也欢迎通过 Issues 提出，但是否实现及具体排期以维护计划为准。
本仓库采用 GNU Lesser General Public License v3.0，对应 SPDX 标识 LGPL-3.0-only；第三方材料仍遵循各自的许可条款。
简单说：你可以使用、学习、修改和分发 ECHO；如果分发了修改过的 ECHO，则需要保留 LGPL 许可，并让接收者能取得对应的 ECHO 源码与修改内容。别把改过的 ECHO 锁成闭源黑盒就好。参考了 ECHO 的代码或设计，也请在项目里留个名字或链接~ 完整权利与义务仍以 LICENSE 为准。
ECHO 的很多能力不是凭空出现的，向这些优秀的开源项目、音频技术与标准致敬：
| 项目 / 技术 | 在 ECHO 中做什么 |
|---|---|
| FFmpeg / libav | 音频解码与媒体处理基础设施 |
| SoX Resampler / libsoxr | 高质量 PCM 重采样的参考与可用后端 |
| SQLite / better-sqlite3 | 本地曲库与索引存储 |
| TagLib / music-metadata | 音频标签、封面与元数据读取 |
| Electron / React | 桌面壳、界面与交互开发体验 |
| WASAPI / ASIO | Windows 音频设备与低延迟输出能力 |
| NVIDIA CUDA | ECHO SRC 的可选计算路径 |
ECHO SRC、ECHO SDM、dither、噪声整形、FIFO 与输出调度是项目自己的实现和取舍；它们也站在长期音频工程经验与这些技术基础之上。谢谢每一位把工具、标准和知识留给后来者的人。
感谢每一位仍在使用、测试、反馈和支持 ECHO NEXT 的朋友。
项目会以新的方式，继续向前。
大大方方承认：ECHO 的开发里用了 AI。它会帮我查资料、整理思路、写掉一些重复劳动；但代码能不能跑、声音会不会出问题、设备会不会翻脸，最后还是要靠测试、日志、真机和我自己一点点收拾。目前我对ECHO的质量还是很肯定的，我能确保这可以端给大家！
我是个人开发者，做得不完美的地方请多多包涵。作者吃软不吃硬：带着复现步骤、日志和正常语气来反馈，我会认真看、认真修；如果用喷人的语气反馈问题，那我一定会喷回去的。（真的会。）
- Email: nyafairy233@gmail.com
- Discord:
Moekotori
ECHO 是本地优先的音乐播放器，不是盗版分发工具，也不替任何第三方流媒体平台提供内容或授权。涉及第三方服务时，账号、内容与使用权限均由用户自行依法取得并遵守对应平台的规则。
ECHO 不会提供超出合法使用范围、侵害音乐人、版权方或平台权益的功能：不绕过访问控制，不破解平台限制，不提供未授权下载歌曲、规避付费权益或其他侵权能力。