# Ampd

Ampd is a free, self-hosted web client for Music Player Daemon that lets users browse music libraries and control playback from a modern, responsive interface. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2298/ampd

## Description

Ampd is a free, self-hosted web client for Music Player Daemon that lets users browse music libraries and control playback from a modern, responsive interface.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

57/100 (Fair), based on 5 of 5 factors.
- Maintained: 94 (last commit 47 days ago)
- Popular: 36 (59 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 20 (16 GB minimum RAM, runs on ARM)
- Security check: 60 (no serious findings, 12 minor, tests)

## Links

- Docker Hub: https://hub.docker.com/r/rain0r/ampd
- Official website: https://rain0r.github.io/ampd/
- Unraid: https://ca.unraid.net/apps/ampd-1imhu3s1jlaiic?q=ampd
- GitHub: https://github.com/rain0r/ampd
- Documentation: https://rain0r.github.io/ampd/docs/faq.html

## Common questions

### Can ampd run on a different computer from the MPD server?

Yes, ampd can run on a separate computer. Set mpd.server either at startup with -Dmpd.server= or in ampd.conf, and use mpd.port if MPD is not on the default port 6600.

### Why might album covers not appear in ampd?

Make sure ampd is started with -Dmpd.music.directory or that the parameter is set in ampd.conf. For current-track covers, also enable MusicBrainz covers with -Dmb.cover.service=true and ensure a cover exists in the local cover cache.

### How do I enable ListenBrainz scrobbling in ampd?

Fill out listenbrainz.token in application.properties. Set listenbrainz.scrobble to turn scrobbling on or off.

### How do I get similar tracks from Last.fm without scrobbling?

Set lastfm.api.key in application.properties. No username, password, or API secret is needed for similar tracks only.

### Can ampd be deployed behind a reverse proxy?

Yes, ampd can be deployed behind another web server using a reverse proxy. The repository points to deployment.md for that setup.

---
Source: Our Local Host (https://ourlocalhost.com/app/2298/ampd), the self-hosted and open-source app directory.
