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

Requirements


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

Download Statistics

2,965
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