Skip to content

Commit

Permalink
README: update with latest changes, minor version bump
Browse files Browse the repository at this point in the history
  • Loading branch information
xkonni committed Apr 15, 2020
1 parent b21c6ad commit 97d2c59
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 37 deletions.
72 changes: 36 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,44 @@
# snapcastr

Snapcastr is a webinterface to control a [snapcast](https://github.com/badaix/snapcast/) server.
## introduction

It is written in python with flask, wtforms and python-snapcast
Snapcastr is a webinterface to control a [snapcast](https://github.com/badaix/snapcast/)
server.

It is written in python with flask, wtforms and python-snapcast

- [python 3](https://www.python.org/)
- [flask](http://flask.pocoo.org/)
- [wtforms](https://wtforms.readthedocs.io)
- [python-snapcast]( https://github.com/happyleavesaoc/python-snapcast)

install from [source](https://github.com/xkonni/snapcastr#install-from-source) or from
[pypi](https://github.com/xkonni/snapcastr#install-from-pypi)


## getting started
## install from source

### install requirements
### requirements

use your package manager, e.g. apt or pacman and install

- python3
- poetry

### install

#### get source
### get source

```bash
$ git clone https://github.com/xkonni/snapcastr
```

#### install locally
### install locally

```bash
$ cd snapcastr
$ poetry install
```

#### install system-wide
### install system-wide

```bash
$ cd snapcastr
Expand All @@ -43,10 +47,23 @@ $ sudo pip3 install dist/snapcastr-0.1.0.tar.gz
```


## run/debug
### run
## install from pypi

### install locally

```bash
$ pip install snapcastr
```

### install system-wide

```bash
$ sudo pip install snapcastr
```

show help
## run

### show help

```bash
$ snapcastrd -h
Expand All @@ -64,11 +81,9 @@ optional arguments:
-c CONFIG, --config CONFIG
config file
-d, --debug debug mode


```

run the application
### run the application

- when installed locally

Expand All @@ -87,29 +102,15 @@ The `address_of_your_snapserver` might be 127.0.0.1 or localhost, if you are run
snapcastr on the same machine as your snapserver. Snapcastr doesn't need to run with super
user privileges (so you don't need to run it with `sudo`).

Be aware that the last used configuration is saved in `$HOME/.config/snapcastr.json`.
### config
The last used configuration is saved in `$HOME/.config/snapcastr.json` and can also be
edited.

### debug

to debug the application
## access webinterface

- when installed locally

```bash
$ cd snapcastr
$ poetry run snapcastrd -d [other-options]
```

- when installed system-wide

```bash
$ snapcastrd -d [other-options]
```


## use

Open http://localhost:5011 in your browser.
When the application is running, open [http://localhost:5000](http://localhost:5000) in
your browser.


## features
Expand All @@ -131,7 +132,6 @@ Open http://localhost:5011 in your browser.
![streams](https://github.com/xkonni/snapcastr/blob/master/doc/streams.png)



## roadmap, in no particular order

### clients
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[tool.poetry]
name = "snapcastr"
version = "0.2.0"
version = "0.2.1"
description = "webinterface to control a snapcast server"
readme = "README.md"
authors = ["xkonni <[email protected]>"]
Expand Down

0 comments on commit 97d2c59

Please sign in to comment.