moOde audio player
为树莓派打造的发烧级音频播放器系统，界面精美，无广告追踪，高保真音质。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
把树莓派变成高端音乐播放器，免费又纯净。
核心功能
- 🎵 支持高解析音频（DSD、PCM等）和多种流媒体协议（AirPlay、Spotify Connect、蓝牙）
- 🖥️ 响应式 Web 界面，手机/平板/电脑均可轻松操控
- 🔇 完全无广告、无订阅、无追踪，本地数据不上传
- 🔧 基于 Debian 的稳定系统，自动构建，更新简便
- 👥 活跃的社区论坛，专业支持与音频爱好者交流
避坑指南
- •🔴 仅支持树莓派2B/3B/3B+/4B/Zero 2W（非所有型号），需注意兼容性。🔴 默认音频输出为HDMI或3.5mm，若要使用I2S DAC需额外配置和硬件。🔴 首次设置需有线网络或提前配置WiFi（可将wpa_supplicant.conf放入boot分区）。
适用场景
- 将闲置树莓派用作客厅高保真音乐播放器
- 搭建多房间同步音频系统
- 作为网络流媒体桥接设备（Roon Ready、UPnP）
详细介绍
moOde 是一个专为树莓派打造的完整操作系统，可将其变为一台发烧级音乐流媒体播放器。基于 MPD 音乐播放守护进程，提供精美且响应迅速的 Web 界面，支持高解析音频、AirPlay、Spotify Connect、蓝牙及多房间同步。系统采用标准 Debian 打包与 Pi-gen 构建工具，确保稳定可靠且易于更新。完全无广告、无订阅、无分析追踪，用户隐私至上。活跃的社区论坛提供专家解答和音频话题讨论。
常见问题与排障 (1)
故障排除如何修复启用 Autoplay 时 moOde 10.1.2 Web UI 加载不完整或卡死的问题？
这是由于 engine-mpd.php 在启动过程中挂起造成的，此时 Autoplay 正在尝试恢复播放，通常是因为队列中存在有问题的条目或流媒体。日志中通常会显示 Engine-mpd: socket timeout (600000 secs)。解决方法：在 moOde 设置中禁用 Autoplay，然后使用 sudo reboot 重启 Raspberry Pi。重启后，完整的 Web UI 应该能够正常加载。如果您需要 Autoplay，请先清除或检查 MPD 播放列表/队列，并移除有问题的条目或流媒体——例如日志中显示的恢复的 songid 27——然后再重新启用 Autoplay。您可以使用 curl -v "http://127.0.0.1/engine-mpd.php?state=undefined" 在本地确认挂起情况；如果请求始终没有返回，则表明存在同样的启动阻塞。清除浏览器缓存或换用其他浏览器无法解决此问题，因为问题出在服务器端。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：从官网下载最新镜像（.img.xz）
步骤2：使用 BalenaEtcher 或 Raspberry Pi Imager 写入 microSD 卡
步骤3：插入树莓派，插电开机，连接网络（有线或WiFi）
- 步骤1：从官网下载最新镜像（.img.xz）
- 步骤2：使用 BalenaEtcher 或 Raspberry Pi Imager 写入 microSD 卡
- 步骤3：插入树莓派，插电开机，连接网络（有线或WiFi）
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
直接格式化SD卡即可完全移除系统。如需保留配置，可先备份 /var/lib/mpd 和 /mnt 目录。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ