Harmonoid:跨平台本地音乐播放与音乐库管理工具
Harmonoid 是一款支持 Windows、GNU/Linux、macOS、Android 与 iOS 的音乐播放与音乐库管理软件,采用 Material Design 3/2 与明暗主题,具备歌词(LRC、标签与在线)、歌词翻译、通知栏歌词、歌手图片、播放列表、无缝播放、倍速与音调调节、音量增强、交叉淡入淡出、ReplayGain、独占音频、标签编辑、Last.fm 与 Discord RPC 集成等特性,基于 mpv/FFmpeg 后端,安装包约 35 MB、内存占用约 150 MB。
社区作者 · zZz
它解决什么问题
Harmonoid 是一个跨平台的音乐播放与音乐库管理开源项目,官方口号为“Plays & manages your music library. Looks beautiful & juicy.”。
核心特性(来源页面列出):
- 高性能媒体库与标签读取器;
- Material Design 3 与 Material Design 2 界面;
- 明色与暗色主题;
- 歌词支持(LRC、音频标签与在线歌词)、歌词翻译、通知栏歌词;
- 歌手图片;
- 播放列表;
- 无缝播放(Gapless playback);
- 变速与变调;
- 音量增强;
- 交叉淡入淡出(Crossfade);
- ReplayGain;
- 独占音频(Exclusive audio);
- 标签编辑器;
- Last.fm 集成;
- Discord RPC 集成;
- mpv/FFmpeg 后端,支持所有文件格式;
- 多歌手与多流派支持;
- 封面回退支持(如 cover.jpg、Folder.jpg 等);
- 小体积安装包(约 35 MB)与低内存占用(约 150 MB);
- 良好的向后兼容:Windows 10+、macOS 10.15+、Android 7.0+、iOS 14.0+;
- 支持便携(Portable)运行;
- 跨平台:Windows、GNU/Linux、macOS、Android、iOS;
- 系统级媒体控制:Windows 的 System Media Transport Controls 与任务栏缩略图工具栏,GNU/Linux 的 D-Bus MPRIS 控制,macOS 与 iOS 的 MPNowPlayingInfoCenter,Android 的 Notification.MediaStyle。
项目动机(Why):作者认为桌面上很难找到设计与动画俱佳的软件,部分看起来不错的音乐播放器存在运行不稳、拒绝支持某些音频格式、标签读取错误、缺少所需功能或直接使用 electron.js 的问题。Harmonoid 严格实现 Material Design,力求在各平台保持一致、连贯、现代的体验,间距与对齐经过仔细处理,并在开发中投入了充分的时间。
本地化:可在 harmonoid/localizations 仓库中帮助添加或更新本地化内容。
界面预览:页面提供了配图 1 至配图 12(含 macOS 明色与暗色主题的多张截图),可用于了解播放列表、歌词、歌手等界面形态。
许可证:本项目及本仓库下的工作受 PolyForm Strict License 1.0.0 约束,具体条款见仓库中的 LICENSE 文件。除许可证与功能列表外,来源页面未提供源码编译、依赖安装或具体的命令行构建步骤。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
来源页面仅提供官方网站(Website)与下载(Download)入口,未给出源码编译命令,以下为可确认的安装与首次使用流程:
一、准备环境
- 操作系统需满足向后兼容要求:Windows 10 及以上、macOS 10.15 及以上、Android 7.0 及以上、iOS 14.0 及以上;GNU/Linux 亦在支持列表中(具体发行版与依赖要求来源未说明,待核验)。
- 预留磁盘空间:安装包体积约 35 MB(实际占用以安装后为准)。
- 运行内存:软件自身内存占用约 150 MB 量级。
- 可联网环境为可选项,用于在线歌词、歌手图片、Last.fm、Discord RPC 等联网功能。
二、获取与安装
- 在项目页面点击 Website 或 Download 链接进入官方站点。
- 按当前系统选择对应平台版本:Windows、GNU/Linux、macOS、Android、iOS。
- Windows 版支持便携(Portable)方式,可直接使用;安装包体积约 35 MB。
- 移动端(Android 7.0+、iOS 14.0+)按平台常规方式安装。
三、首次运行
- 启动后添加/扫描本地音乐目录,建立媒体库并读取音频标签。
- 若曲目缺少内嵌封面,软件会尝试回退封面文件(如 cover.jpg、Folder.jpg 等)。
- 需要歌词时可启用 LRC、标签歌词或在线歌词;需要歌词翻译与通知栏歌词时在相应设置中开启。
- 如需听歌记录或社交状态展示,可分别配置 Last.fm 与 Discord RPC 集成。
- 追求更好音质表现时,可尝试独占音频、ReplayGain、交叉淡入淡出、变速/变调与音量增强等选项。
四、常见问题提示
- 播放兼容性:项目使用 mpv/FFmpeg 后端并声明支持所有文件格式,如遇个别格式异常,可优先检查后端相关组件。
- 标签或封面显示不正确:可使用内置标签编辑器修正,或放置 cover.jpg、Folder.jpg 等回退封面文件。
- 系统媒体控制失效(Windows 媒体控制/任务栏工具栏、GNU/Linux MPRIS、macOS/iOS Now Playing、Android 通知媒体样式):不同平台机制不同,需在系统层面允许相应权限或媒体控制。
- 源码构建、依赖安装与打包命令:来源页面未提供,待核验。