https://github.com/rain0r/ampd

A web-based MPD client.
https://github.com/rain0r/ampd

angular java mpd mpd-client music-player spring-boot typescript websockets

Last synced: 18 days ago
JSON representation

A web-based MPD client.

• Host: GitHub
• URL: https://github.com/rain0r/ampd
• Owner: rain0r
• License: gpl-3.0
• Created: 2019-09-10T19:16:46.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2026-01-11T19:49:11.000Z (22 days ago)
• Last Synced: 2026-01-11T23:34:57.164Z (22 days ago)
• Topics: angular, java, mpd, mpd-client, music-player, spring-boot, typescript, websockets
• Language: TypeScript
• Homepage: https://rain0r.github.io/ampd/
• Size: 9.84 MB
• Stars: 57
• Watchers: 2
• Forks: 6
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ampd

ampd is a free web-based client for [MPD](https://www.musicpd.org/). 

Desktop (dark theme)             |  Mobile (light heme)

:-------------------------:|:-------------------------:

![Screenshot of ampd on a desktop](assets/screenshots/desktop.png)  | ![Screenshot of ampd on a mobile device](assets/screenshots/mobile.png)

More screenshots can be found in the [**wiki**](https://github.com/rain0r/ampd/wiki/Screenshots).

## Features

* Modern and responsive UI

  * Built with [Angular](https://angular.io/) and [Angular Material](https://material.angular.io/)

  * 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

  * Displays image files from the music directory

  * Support for the [MusicBrainz Cover Art Archive/API](https://wiki.musicbrainz.org/Cover_Art_Archive/API)

* `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](https://github.com/rain0r/ampd/releases/latest) and start it via: 

```sh

java -jar ampd.jar

```

For more options, please see: [usage.md](docs/usage.md)

If you want to deploy `ampd` behind another webserver via reverse proxy, please see: [deployment.md](docs/deployment.md) 

To run `ampd` with docker, please see: [docker.md](docs/docker.md)

There's also a [faq.md](docs/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](docs/dev.md)