Add README
This commit is contained in:
parent
ca92edef42
commit
f471bd77a6
|
@ -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.
|
Loading…
Reference in New Issue