This is a web app to control a server instance of cmus, a powerful music player, remotely. It supports basic player, volume and mode controls, can fetch and show the albumart-image from current files' folder and display all tags. But you can't add items to the playlist or manage the queue.

If you want to run this web app and cmus itself in backgound and optionally automatically on system-startup check out cmus_daemon!

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/ichier/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.