mpz：面向大型本地音乐库的文件夹音乐播放器 #

mpz 是什么？ #

mpz 是一款面向大型本地音乐收藏的文件夹音乐播放器，它把用户已有的目录结构直接当作音乐库，不需要任何导入、扫描或建立索引的步骤——添加音乐文件夹，立刻就能播放。

它使用原生 C++ 与 Qt 6 编写，定位是"轻量、快速、跟随桌面主题"的本地播放器，可在 Linux、macOS 和 Windows 上跨平台运行，并以 GPL-3.0 协议免费开源。对于习惯用文件夹整理音乐、不希望播放器自建一套媒体库的用户，mpz 提供了三栏式界面（目录树 / 播放列表 / 曲目）、无缝播放、均衡器、ReplayGain 音量归一化、网络电台、标签编辑、歌词与封面显示等能力。它的设计灵感来自 Foobar2000 的"专辑列表"，但并非复刻，而是只保留了作者多年日常使用的功能集合。

mpz 有哪些亮点特色？ #

• 文件夹就是音乐库，零导入成本：mpz 不会建立自己的媒体库索引，你的目录树就是库。在目录树中中键单击任意文件夹即可将其生成一个播放列表，也可以从文件管理器直接拖拽文件夹和曲目进来，适合动辄几十万首曲目的大型收藏。

• 三栏式界面，操作直觉高效：窗口分为目录树（库）、播放列表、所选播放列表的曲目三列，文件夹、电台、曲目都可以在三栏之间拖动，曲目支持拖拽排序，全部操作无需学习成本。

• 真正的无缝播放（Gapless）：曲目之间没有静音间隙，单文件整轨专辑配合 CUE 表同样无缝。解码后的音频会缓存在内存中（默认 100 MB，可在"设置 → 高级"中调整），因此拖动进度条也是瞬间响应（需 Qt 6 构建版本）。

• 10 段图形 + 全参数均衡器：均衡器提供 10 段图形与完整参数化两种模式，可导入 AutoEq、SquigLink 等来源的预设，也支持导出配置。每个输出设备（"Default"也算一个）都有独立的开关与预设，预设本身共享；拔掉耳机切换到别的设备时，均衡器会跟随设备自动切换。

• ReplayGain 音量归一化 + 动态范围表：读取文件已有的 ReplayGain 标签，也能在后台自行测量——针对当前播放列表、选中曲目或整个音乐库。结果默认写入独立数据库，不改动原文件，也可以选择写回标签。支持曲目/专辑增益、前置放大、削波保护，以及可选的动态补偿，让金属与流行乐不会比古典和爵士听起来更轻。此外还提供 foobar2000 Dynamic Range Meter 格式的单曲与专辑 DR 记录。

• 网络电台 + 实验性 mpd 客户端模式：m3u、m3u8、pls 流播放列表可直接播放或导入电台库，内置 SomaFM、Radio Paradise、FIP、France Musique、Nightride FM 等电台，支持 HTTPS 流与 IceCast 曲目标题。还可以把 mpd（Music Player Daemon）服务器作为一个库文件夹添加，像本地文件一样浏览和播放远程音乐。

• 原生轻量，跨平台一致体验：原生 C++/Qt 6 构建（老发行版另有 Qt 5 版本），启动快、大库下依然流畅，界面使用系统主题与系统已安装的音频编解码器。支持 MPRIS（Linux，可配合 KDE Connect 遥控）、SMTC 与任务栏按钮（Windows）、Now Playing 与 Dock 菜单（macOS），并提供系统托盘与全局媒体键。

• 开源免费，功能不缩水：GPL-3.0 协议开源，所有功能完整开放，包含标签编辑器（TagLib，支持 ID3v2、Vorbis Comment、MP4、APE）、波形进度条、播放记录、可自定义快捷键、封面与歌词（本地或可选在线源）、更新检查（AppImage 支持增量更新）以及 English、Russian、Japanese、Serbian 多语言界面。

免费下载 mpz #

以下为官方提供的各平台安装包（版本 2.1.7），点击链接即可下载。请根据自己的操作系统与硬件架构选择对应版本。

提示：如果你使用的是 openSUSE、Debian、Fedora、Ubuntu、RedHat、Mageia、Arch 或 Manjaro，官网建议优先使用原生软件包安装，可获得更好的系统集成与更新体验。

mpz 如何使用？ #

mpz 的设计理念是"打开即用"，几乎没有学习曲线，基本流程如下：

1. 启动并认识主界面 打开 mpz 后，窗口分为三列：左侧是目录树（库），中间是播放列表，右侧是所选播放列表的曲目。上方工具栏包含波形进度条与输出设备切换按钮（波形默认关闭，可在"设置 → 界面"中开启）。

2. 把音乐文件夹加入库 你不需要"导入"任何东西。在目录树中定位到音乐所在目录即可开始使用；也可以直接从系统文件管理器把文件夹或曲目拖拽进窗口。想要把某个文件夹变成播放列表，在目录树中对它中键单击即可自动生成。

3. 播放与整理曲目 双击曲目开始播放。曲目可以通过拖拽排序，文件夹、电台和曲目都能在三栏之间拖动；在播放列表上可以设置播放顺序（顺序、随机、不循环），并支持全局或按播放列表分别设置，还可使用曲目排序预设。

4. 调整音质与音量 在设置中启用均衡器，选择 10 段图形或全参数模式，导入 AutoEq / SquigLink 预设；开启 ReplayGain 后，可让 mpz 在后台测量当前播放列表、选中曲目或整个音乐库的音量，并选择写入独立数据库（不改动原文件）或直接写回标签。

5. 使用电台、标签与歌词等扩展功能 把 m3u / m3u8 / pls 流播放列表直接拖入即可播放，或导入内置电台库（含 SomaFM、Radio Paradise、FIP 等）。右键曲目可打开标签编辑器修改 ID3v2、Vorbis Comment、MP4、APE 标签；封面与歌词默认读取内嵌标签或同目录的 .lrc / .txt 文件，在线来源（Deezer、Apple Music、Cover Art Archive、LRCLIB 等）默认关闭，需在"设置 → 在线歌词与封面"中手动开启。

6. 个性化与便携使用 所有快捷键都可以在快捷键对话框中重新绑定（全局媒体键除外）。配置以两个 YAML 文件保存：一个可复制到其他电脑的全局配置，一个仅本机使用的配置，方便便携化迁移。

mpz 的常见问题？ #

mpz 需要先把音乐导入媒体库吗？ 不需要。mpz 是一款文件夹播放器，你的文件夹结构本身就是音乐库，没有全局索引步骤。添加音乐文件夹即可播放，也不会因为扫描而久等。

Windows 首次启动时被 SmartScreen 拦截怎么办？ 这是因为官方构建没有代码签名。在 Microsoft Defender SmartScreen 提示"Windows 已保护你的电脑"时，点击更多信息，再点击仍要运行即可；如果没有"仍要运行"按钮，可右键文件 → 属性 → 勾选"解除锁定" → 应用。若开启的是 Smart App Control（仅全新安装的 Windows 11 默认开启），则需要在 Windows 安全中心 → 应用和浏览器控制 → Smart App Control 中先关闭它，安装完成后再打开。

macOS 提示"无法验证开发者"如何解决？ 官方构建没有 Apple Developer ID 签名，Gatekeeper 会在首次启动时拦截。把 mpz music player.app 拖入 /Applications 后，有两种方式：一是执行终端命令 xattr -dr com.apple.quarantine "/Applications/mpz music player.app"，之后正常打开；二是在系统设置 → 隐私与安全性中，找到关于 mpz 被阻止的提示，点击"仍要打开"并确认。

mpz 支持哪些音频格式？ mpz 使用系统已安装的编解码器（Linux 上为 QtMultimedia + GStreamer / ffmpeg，macOS 与 Windows 使用原生后端），支持 FLAC、MP3、Ogg Vorbis、Opus、Speex、AAC、ALAC、M4A/M4B/MP4、WAV、AIFF、WMA/ASF、APE、WavPack、Musepack、TTA、MKA、DSD（DSF/DFF）、Shorten 等常见格式。

无缝播放需要满足什么条件？ 无缝播放与内存缓冲需要 Qt 6 构建版本，Qt 5 的老版本不具备该能力。默认缓存 100 MB，可在"设置 → 高级"中调整。

换耳机后均衡器设置会失效吗？ 不会。均衡器的开关与所选预设是按输出设备保存的（"Default"也算一个设备），当音频设备发生变化（例如拔掉耳机）时，均衡器会跟随当前设备自动切换，而预设本身在所有设备间共享。

mpd 客户端模式稳定吗？ 该功能自 2.0.0 版本加入，官方明确标注为实验性功能。由于 mpd 的媒体库模型与 mpz 的"文件夹即播放列表"模型并不完全对应，部分交互行为会与本地文件夹不同，具体限制可查阅项目 README 中的 "mpd impedance mismatch" 章节。

mpz 如何安装？ #

Windows #

1. 从上方下载表格中选择版本：一般 64 位电脑推荐 mpz-2.1.7-win-x86_64-qt6-installer.exe；Windows on ARM 设备选择 arm64 版本；Windows 10 之前的 32 位老系统选择 win-legacy-qt5。
2. 安装版：双击运行 .exe，按向导完成安装，会创建开始菜单快捷方式并注册卸载程序。
3. 便携版：下载 portable.zip 后解压到任意目录，直接运行可执行文件即可，不会写入系统，也不会创建开始菜单项。
4. 首次启动如遇 SmartScreen 拦截，按上文说明点击"更多信息 → 仍要运行"。

macOS #

1. 下载 mpz-2.1.7-macos-universal.dmg（通用二进制，支持 Apple Silicon 与 Intel，需 macOS 11 Big Sur 或更高版本）。
2. 打开 dmg，将 mpz music player.app 拖入 /Applications。
3. 由于未签名，首次启动需按上文两种方式之一绕过 Gatekeeper（终端 xattr 命令或系统设置的"仍要打开"）。
4. 也可以克隆源码后按 README 自行编译。

Linux #

1. 原生软件包（推荐）：适用于 openSUSE、Debian、Fedora、Ubuntu、RedHat、Mageia、Arch 与 Manjaro，提供 stable（推荐）与 unstable（master 构建）两个通道，分别有 x86_64 与 aarch64 版本。该仓库只包含 mpz，不会影响系统其他组件，也可以直接下载软件包而不添加仓库。
2. Flatpak：在 Flathub 或桌面软件中心安装，命令为：

   flatpak install flathub org.mpz_player.mpz
   

3. AppImage：从 GitHub Releases 页面下载 x86_64 或 aarch64 的 AppImage，赋予可执行权限后直接运行。AppImage 支持更新检查与增量（zsync）更新。
4. AUR：Arch 与 Manjaro 用户除原生包外，也可以使用 AUR 中的 mpz 包。

安装完成后，mpz 会自动使用系统桌面主题与已安装的音频编解码器，无需额外配置。

mpz 如何卸载？ #

Windows #

• 安装版：点击开始菜单中的"Uninstall mpz"快捷方式，或在控制面板 → 程序和功能中选择 mpz 卸载。注意：Windows 11 上"设置 → 应用"可能无法正常卸载，这是 Qt Installer Framework 的一个已知问题，请改用开始菜单快捷方式或控制面板。
• 便携版：直接删除解压出来的文件夹即可，系统不会残留安装记录。
• 如需彻底清理，可一并删除用户目录下 mpz 的配置文件夹（两个 YAML 配置文件）。

macOS #

1. 打开"访达 → 应用程序"，将 mpz music player.app 拖入废纸篓并清空。
2. 如需清理配置，可在终端或访达中删除用户资源库下与 mpz 相关的配置与缓存目录（mpz 使用 YAML 配置文件保存设置）。

Linux #

• 原生软件包：使用对应发行版的包管理器卸载，例如 apt remove mpz、dnf remove mpz、zypper remove mpz 或 pacman -R mpz（具体包名以实际安装为准）。
• Flatpak：执行

  flatpak uninstall org.mpz_player.mpz
  

• AppImage：直接删除 AppImage 文件即可，本身不写入系统。
• AUR：使用你的 AUR 助手执行卸载（如 yay -Rns mpz）。

提示：mpz 的配置保存在两个 YAML 文件中（一个全局、一个本机专用），卸载程序通常不会自动删除它们。如果你希望完全恢复到初始状态，可在卸载后手动删除这两个文件；ReplayGain 的测量结果默认存放在独立数据库中，也需要手动清理。