Add README

This commit is contained in:
Agatha Lovelace 2022-09-23 19:40:00 +02:00
parent ca92edef42
commit f471bd77a6
Signed by: sorceress
GPG Key ID: 11BBCFC65FC9F401
1 changed files with 36 additions and 0 deletions

36
README.md Normal file
View File

@ -0,0 +1,36 @@
# Eleanor Server
A HTTP remote media server for the [Eleanor](https://github.com/AgathaSorceress/Eleanor) music player.
## Usage (command line)
- Setup:
1. Run the `eleanor-server` executable; exit
2. Edit the `settings.toml` file. Example:
```toml
port = 8008
[[sources]]
id = 0
path = "/home/agatha/Music/local/"
```
3. Add user(s) using the `user` subcommand
4. Start the server again
- Adding a user:
```sh
./eleanor-server user add username password
```
- Removing a user:
```sh
./eleanor-server user remove username
```
## REST API Implementation
`GET /` → A binary messagepack-encoded list of tracks indexed by the server
`POST /` → Starts a full reindex by the server
`GET /:hash ` → Responds with the requested song's audio file (hash can be obtained from the index)
`GET /:hash/cover` → Responds with the album art attached to the requested song's file
All endpoints require HTTP Basic Auth using credentials of any formerly added user.