ampd

ampd

Docker app from grtgbln's Repository

Overview

ampd is a free web-based client for MPD.

ampd

ampd is a free web-based client for MPD.

Desktop (dark theme) Mobile (light heme)
Screenshot of ampd on a desktop Screenshot of ampd on a mobile device

More screenshots can be found in the wiki.

Features

  • Modern and responsive UI
    • Built with Angular and Angular Material
    • Light and dark theme included
    • Customizable
      • Multiple features can be switched on and off
  • No external JavaScript / CSS files loaded: 100% self hosted
    • No telemetry
  • Support for album cover art
  • ncmcpp-like shortcuts
  • Support for Internet Radio Streams
  • Support for scrobbling
    • Last.fm
    • ListenBrainz
  • Distributed as a single jar-file

Running

To start, just download the latest release and start it via:

java -jar ampd.jar

For more options, please see: usage.md

If you want to deploy ampd behind another webserver via reverse proxy, please see: deployment.md

To run ampd with docker, please see: docker.md

There's also a faq.md

Caveats

  • JRE 17 or higher needed
  • Only one mpd server supported simultaneously

Contributing / hacking / developing

All types of contributions are welcome:

  • Bug tickets
  • Pull requests
  • Suggestions
  • Screenshots
  • Documentation

If you like to fork / edit / work on ampd, please see: dev.md

Install Ampd on Unraid in a few clicks.

Find Ampd in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Ampd Review the template variables and paths Click Install

Requirements


        May require additional configuration. See documentation: https://rain0r.github.io/ampd/docs/docker.html
    

Download Statistics

1,834
Total Downloads

Details

Repository
rain0r/ampd:latest
Last Updated2026-01-21
First Seen2025-07-30

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Privileged
false

Template configuration

Web UI PortPorttcp

Container Port: 8080

Target
8080
Default
8080
Value
8080
MPD ServerVariable

URL to the MPD server.

Target
MPD_SERVER
MPD PortVariable

Port of the MPD server.

Target
MPD_PORT
Default
6600
Value
6600
Enable Local Cover CacheVariable

Enable local cover cache for faster loading of covers.

Target
LOCAL_COVER_CACHE
Default
false|true
MB Cover CacheVariable
Target
MB_COVER_CACHE
Default
false|true
Reset Modes on ClearVariable
Target
RESET_MODES_ON_CLEAR
Default
false|true
Create New PlaylistsVariable
Target
CREATE_NEW_PLAYLISTS
Default
false|true
Delete Existing PlaylistsVariable
Target
DELETE_EXISTING_PLAYLISTS
Default
false|true
Internal Working DirectoryVariablerw

Internal working directory for ampd. Do not change unless you know what you are doing.

Target
HOME_DIR
Default
/opt/ampd/home
Value
/opt/ampd/home
Working DirectoryPathrw

Path to the working directory. This is where ampd stores its data.

Target
/opt/ampd/home
Default
/mnt/user/appdata/ampd
Value
/mnt/user/appdata/ampd