# ampd-MPD

**Repository Path**: lcyt/ampd-mpd

## Basic Information

- **Project Name**: ampd-MPD
- **Description**: 使用Spring Boot、Angular和websockets的现代和移动友好的web UI。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-09
- **Last Updated**: 2025-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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)