moOde audio player
Audiophile-grade music player OS for Raspberry Pi with beautiful responsive UI and no ads or tracking.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Turn your Raspberry Pi into a pristine audio player — free, open, and gorgeous.
Core Features
- 🎵 High-resolution audio (DSD/PCM), AirPlay, Spotify Connect, Bluetooth, multi-room
- 🖥️ Responsive web UI works on phone, tablet, desktop
- 🔇 Zero ads, subscriptions, analytics, or telemetry
- 🔧 Stable Debian-based image with automated builds
- 👥 Active forum community for support and discussion
What It Can't Do
- •🔴 Only compatible with Raspberry Pi 2B/3B/3B+/4B/Zero 2W. 🔴 Default audio output is HDMI or 3.5mm; I2S DAC requires additional hardware config. 🔴 First setup needs wired network or pre-configured WiFi (place wpa_supplicant.conf in boot partition).
Use Cases
- Turn a spare Raspberry Pi into a hi-fi music streamer
- Multi-room synchronized audio system
- Roon Ready / UPnP bridge for existing audio setup
Detailed Introduction
moOde is a complete, turnkey operating system for Raspberry Pi that transforms it into a high-end music streamer. Based on MPD (Music Player Daemon), it delivers a polished web interface with support for Hi-Res audio, AirPlay, Spotify Connect, Bluetooth, and multi-room synchronization. The system is built from standard Debian packaging and Pi-gen, ensuring stability and easy updates. It is completely free of ads, subscriptions, analytics, and telemetry. An active community forum provides expert support and discussions on audio topics.
Troubleshooting & FAQ (1)
TroubleshootingHow do I fix moOde 10.1.2 Web UI partially loading or hanging when Autoplay is enabled?
This is caused by engine-mpd.php hanging during startup while Autoplay tries to resume playback, often with a problematic queue item or stream. The log typically shows Engine-mpd: socket timeout (600000 secs). Workaround: disable Autoplay in moOde settings, then reboot the Raspberry Pi with sudo reboot. After reboot, the full Web UI should load normally. If you need Autoplay, first clear or inspect the MPD playlist/queue and remove the problematic item or stream—such as the resumed songid 27 shown in the log—before enabling Autoplay again. You can confirm the hang locally with curl -v "http://127.0.0.1/engine-mpd.php?state=undefined"; a request that never returns indicates the same startup blockage. Clearing the browser cache or using another browser does not resolve it because the issue is server-side.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Download the latest image from moodeaudio.org
Step 2: Flash to microSD using BalenaEtcher or Raspberry Pi Imager
Step 3: Insert SD, power on, connect to network (Ethernet or WiFi)
- Step 1: Download the latest image from moodeaudio.org
- Step 2: Flash to microSD using BalenaEtcher or Raspberry Pi Imager
- Step 3: Insert SD, power on, connect to network (Ethernet or WiFi)
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Simply format the SD card. To preserve config, back up /var/lib/mpd and /mnt before reformatting.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
1 FAQ
Similar Projects
core
Open source home automation that puts local control and privacy first. Perfect for Raspberry Pi or a local server.
PowerToys
A set of utilities for power users to tune and streamline their Windows experience for greater productivity.
terminal
Modern, feature-rich terminal application for Windows command-line users, with tabs, GPU acceleration, and full customization.