diff --git a/README.md b/README.md index 9d8aa38..cbcd62f 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 diff --git a/pyproject.toml b/pyproject.toml index a1f03b2..2507371 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -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 "]