Self-host ampd
ampd-2.2.11Web-based MPD client with modern responsive UI
- Stars
- 59
- Port
- 8080 (HTTP web interface)
- Requires
- Music Player Daemon (MPD)
rain0r/ampd
What is ampd?
ampd is a web-based client for Music Player Daemon (MPD) that runs in a browser. It offers a responsive interface with light and dark themes, displays album covers from local files or the MusicBrainz Cover Art Archive, supports internet radio streams, and can scrobble playback to Last.fm and ListenBrainz. Keyboard shortcuts similar to ncmcpp are included. The application is packaged as a single JAR file requiring Java 17 or newer, defaults to port 8080, and can be run via Docker, systemd, or behind a reverse proxy. Only one MPD server can be connected at a time.
Should you self-host ampd?
ampd scores 42/100 on selfhost.directory (how scoring works) and ranks #40 of 59 in Music Streaming. It has 59 GitHub stars.
It shipped 5 stable releases in the past year. The latest, ampd-2.2.11, came out on 5 October 2026. New versions land roughly every 5 weeks.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is koel (75/100, 17 320 stars). It scores higher overall, so compare the two before you pick. See ampd vs koel side by side.
Features
- Album cover art support
- Internet radio streams
- Keyboard Shortcuts
- No external resources
- Reverse proxy deployment
- Scrobbling to Last.fm
- Scrobbling to ListenBrainz
- Single JAR distribution
ampd README
FAQ
Do I have to run ampd on the same computer as the MPD server?
No, ampd can run on a separate computer by setting mpd.server and optionally mpd.port.
Why are there no covers for the currently played track?
Possible reasons: mpd.music.directory not provided, MusicBrainz cover fetching disabled, or no cached cover found.
How can I load similar tracks from Last.fm?
Set lastfm.api.key in application.properties; no username, password, or API secret needed for similar tracks only.
Can I scrobble to Last.fm?
Yes, by configuring lastfm.api.username, lastfm.api.password, lastfm.api.key, and lastfm.api.secret in application.properties.
Can I scrobble to ListenBrainz?
Yes, by setting the listenbrainz.token property in application.properties and enabling listenbrainz.scrobble.
More in Music Streaming
asknavidromeAskNavidrome is an open-source Alexa skill that streams your music from a Subsonic server like Navidrome to Amazon Echo devices, without subscription fees or ads.
auddly-serverAuddly is an open-source, self-hosted music streaming server with a REST API for your personal library, playlists, Last.fm scrobbling, and Spotify artist images.
AudioMuse-AIOpen-source, self-hosted sonic-analysis tool that builds playlists, a 2D music map and semantic search for Navidrome, Jellyfin, Emby, Plex, LMS and Lyrion libraries.
aurralOpen-source self-hosted music discovery with personalized recommendations, rotating playlist flows, and library management. Works standalone or with Lidarr.
Black CandySelf-hosted, open-source music streaming server you run in a single Docker container, with SQLite by default, optional PostgreSQL, and native iOS and Android apps.
cicadaCicada is a self-hosted, open-source multi-user music streaming service with PWA, 2FA, lyrics, and music sharing. Runs as a single binary or via Docker.
cloudtunesOpen-source, self-hosted web music player that unifies your Dropbox files and YouTube videos, with playlists, Last.fm scrobbling and MusicBrainz metadata.
DeaftoneLightweight Rust music server for self-hosted streaming. Simple API, FLAC/MP3/Ogg support, SQLite storage. Alternative to Subsonic.
euterpeEuterpe is an open-source, self-hosted music streaming server for your personal library. Runs as a single binary with web UI, REST API, and native mobile apps.
feishinOpen-source desktop and web music player for Jellyfin, Navidrome and OpenSubsonic servers; the self-hosted Docker image serves the web client on port 9180.
foamSelf-hosted PHP web player for Ampache music servers with Fomantic UI, featuring library browsing, playlists, queue management, and FLAC support.
gonicSelf-hosted, open-source Subsonic server API implementation in Go for streaming your own music: transcoding, podcasts, multi-user, Last.fm and ListenBrainz scrobbling.
0 comments