This repository is in retirement. You may want to check out this fork of cmus_app
instead.
This is a web app to control a server instance of
cmus
, a powerful music player, remotely. It only
supports basic player and volume controls, not adding items to the playlist.
cmus
is required, of course. The backend is written in Python and has been
tested with Python 2.7, Python 3.5, PyPy 4.0, and Pyston 0.4.
All dependencies are bundled. They are bottle
and
sh
. The frontend also makes use of
Zepto, Kube, and Font
Awesome. Thanks to the creators
for making them available under permissive licenses.
The web app can run on the same host as the cmus
instance you want to control
or a different one, but both hosts will have to have cmus
installed.
-
Run an instance of
cmus
using the--listen
option.$ cmus --listen <host>
-
Set a password in
cmus
using:set passwd=<passwd>
.
-
Fetch cmus_app:
$ git clone git:https://github.com/jboynyc/cmus_app $ cd cmus_app
-
Edit the configuration file. (Optional.)
-
Run the app with a configuration file or command-line options:
$ python app.py -f <config_file> $ python app.py -c raspberry -w PaSsWd -a localhost -p 8080
- Open your browser and navigate to
http:https://<host>:<port>
.
Enjoy!
Take a look on the cmus wiki.