🎵 Maestro MPD Server

The Ultimate Self-Hosted Music Server with Professional Web Interface

Transform your music collection into a powerful streaming server with beautiful web UI, automatic CD ripping, Last.fm integration, and comprehensive system management.

Version 2.3.0 MIT License MPD 0.23+ Python 3.8+
View on GitHub Get Started

📹 Video Walkthrough

Complete visual tour of Maestro Server - see all features in action!

Maestro Video Walkthrough
▶

Silent walkthrough demonstrating the web interface, admin panel, and all major features

Maestro Player Interface

🎯 Why Maestro?

Maestro is not just another MPD web interface - it's a complete music server ecosystem designed for audiophiles, self-hosters, and music enthusiasts who demand:

✨

Professional-grade features

CD ripping, multi-disc detection, Last.fm scrobbling

🎨

Beautiful UI

8 gorgeous themes, mobile-responsive, modern design

🔧

Full system control

NFS/SMB mounts, audio configuration, OS updates, real-time monitoring

🚀

Zero-hassle setup

One-command installation, automatic MPD detection, smart defaults

🎵

Audiophile-ready

Bit-perfect playback up to DSD512/384kHz, all formats supported, hardware device selection

📀

Automatic CD ripping

Insert disc → automatic rip → organized library

📸 Screenshots

Theme Variety

Multiple Themes

Choose from 8 beautiful themes to match your style

Desert Theme

Desert theme with warm, earthy colors

High Contrast Theme

High contrast theme for improved accessibility

Library Browsing

Browse Albums

Grid view of your album collection with cover art

Browse Interface

Intuitive browsing with multiple view options

Recently Added

Keep track of newly added albums

Playback Features

Playlist

Manage your current playlist

Search

Powerful search across your library

Last.fm Charts

View your Last.fm listening statistics

Admin Dashboard

Admin Dashboard

System monitoring and library management

System Administration

System updates and service management

Audio Configuration

Advanced audio configuration

CD Ripping & Automation

CD Ripper

Automatic CD ripping with MusicBrainz metadata lookup and album art

CD Ripper Settings

Configure format, quality, output location, and automatic ripping

Mobile Responsive

Mobile View 1 Mobile View 2 Mobile Main Mobile View 4

Fully responsive design that works beautifully on mobile devices

🚀 Quick Start

One-Command Installation & Update

Install:

git clone https://github.com/coacharnold1/Maestro-Server.git cd Maestro-Server ./install-maestro.sh

Update:

cd ~/Maestro-Server ./update-maestro.sh

Installation: The installer will automatically:

Post-Installation

Access your new music server:

  • 🌐 Web Player: http://YOUR_IP:5003
  • ⚙️ Admin Panel: http://YOUR_IP:5004
  • 🎵 MPD Port: YOUR_IP:6600

✨ Key Features

🎧 Modern Web Interface (Port 5003)

Music Playback & Control

  • Full MPD control (play, pause, stop, next, previous)
  • Volume control with visual feedback
  • Real-time playback progress
  • Shuffle and repeat modes
  • HTTP audio streaming

Library Browsing

  • Album browsing with album art
  • Artist browsing with smart letter jump navigation
  • Genre filtering
  • Recent albums page
  • Smart search across artists, albums, and tracks

Advanced Features

  • Playback charts - track your listening stats
  • 8 beautiful themes
  • Mobile-responsive design
  • Last.fm integration with scrobbling
  • Smart toast notifications

⚙️ Powerful Admin Interface (Port 5004)

System Monitoring

  • Real-time stats: CPU, RAM, disk usage
  • Live graphs updating every 2 seconds
  • Disk space monitoring
  • Network traffic monitoring

Library Management

  • NFS/SMB mount management
  • Mount/unmount operations
  • Smart library updates
  • File browser

Audio Configuration

  • Audio device selection
  • Bit-perfect playback configuration
  • Buffer size optimization
  • DSD playback mode

🎯 Perfect For

🏠

Home Music Servers

Central music hub for whole house audio

🎧

Audiophiles

Bit-perfect playback with DSD support

💿

CD Collectors

Automatic ripping with metadata lookup

🖥️

Raspberry Pi

Lightweight, efficient music server

🌐

Remote Access

Stream your collection from anywhere

📚

Large Libraries

Handles 100,000+ tracks with ease

🔌 Related Projects

Expand your Maestro setup with these companion projects

🖼️ MPD Framebuffer Display

View Project →

Display real-time album artwork on framebuffer devices like TFT screens, monitors, or displays connected to your Maestro server.

🔄 Real-time Updates 🌐 HTTP API 📺 Raspberry Pi Ready 🎨 Album Art Display

Perfect For:

  • Mini music players with visual display
  • Kiosk mode music stations
  • Desktop album art visualizer
  • Multi-room audio with visual feedback

Quick Install:

git clone https://github.com/coacharnold1/mpd-framebuffer-display
cd mpd-framebuffer-display
sudo ./install.sh

🛠️ System Requirements

Minimum Requirements

  • OS: Ubuntu 20.04+, Debian 11+, Arch Linux
  • RAM: 1GB (2GB+ recommended)
  • Storage: 1GB + your music library
  • Network: Ethernet or WiFi
  • Audio: Any ALSA-compatible device

Recommended Hardware

  • Raspberry Pi 4 (4GB RAM) - Perfect balance
  • Intel NUC - More power for large libraries
  • Dedicated Linux server - Ultimate performance