empede/README.md

36 lines
1.6 KiB
Markdown
Raw Normal View History

2023-04-27 14:07:48 +00:00
# Empede
2023-05-01 23:45:40 +00:00
2023-05-03 13:26:09 +00:00
[![Drone (self-hosted)](https://img.shields.io/drone/build/_/empede?server=https%3A%2F%2Fci.sijman.nl)](https://ci.sijman.nl/_/empede)
[![Docker Image Size (latest semver)](https://img.shields.io/docker/image-size/vijfhoek/empede)](https://quay.io/repository/vijfhoek/empede)
[![Crates.io](https://img.shields.io/crates/v/empede)](https://crates.io/crates/empede)
2023-05-01 23:45:40 +00:00
2023-04-27 14:07:48 +00:00
**A web client for MPD.**
![Screenshot](screenshots/screenshot.webp)
2023-04-27 22:33:13 +00:00
## Configuration
Empede is configured using environment variables:
2023-05-06 19:10:15 +00:00
| Name | Default | Description |
| ---------------- | ------------ | --------------------------------- |
| **MPD_HOST** | localhost | MPD server host |
| **MPD_PORT** | 6600 | MPD server port |
| **MPD_PASSWORD** | | MPD server password |
| **EMPEDE_BIND** | 0.0.0.0:8080 | Address for Empede to bind to |
2023-04-27 22:33:13 +00:00
2023-04-27 14:07:48 +00:00
## Running
2023-04-27 14:37:54 +00:00
### Linux
2023-04-27 14:40:41 +00:00
1. Download and extract the [latest release](https://git.sijman.nl/_/empede/releases)
2023-04-27 14:37:54 +00:00
2. Run `./empede` (To specify a host and port, run `MPD_HOST=ip MPD_PORT=6600 ./empede`)
3. Go to http://localhost:8080
2023-04-28 10:49:07 +00:00
### Windows
1. Download and extract the [latest release](https://git.sijman.nl/_/empede/releases)
3. Run `.\empede` in a PowerShell (To specify a host and port, first set the `$env:MPD_HOST` and `$env:MPD_PORT` variables)
3. Go to http://localhost:8080
2023-04-27 14:07:48 +00:00
### Building from source
1. Make sure Rust is installed (https://rustup.rs/)
2. Run `cargo run` (To specify a host and port, run `MPD_HOST=ip MPD_PORT=6600 cargo run`)
3. Go to http://localhost:8080