Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > CherryMusic

CherryMusic is a music streaming server based on CherryPy and jPlayer.

This page is deprecated. The app has not received development in years and is unlikely to work. Instructions below are left if you want to experiment.

Installation

  1. Connect to your slot through SSH

  2. Install and activate a Python virtualenv with the instructions from the link

  3. Install the cherrypy dependency

     pip install cherrypy

  4. Download the latest release of CherryMusic

     git clone https://github.com/devsnd/cherrymusic.git

  5. Start the configuration process. Port 21589 has been automatically generated for you, but you may use another 5 digit port between 10000 and 32767.

     screen -mS cherrymusic ~/virtualenv/bin/python ~/cherrymusic/cherrymusic --setup --port 21589

  6. Open http://server.whatbox.ca:21589 in your web browser

  7. Set the Media base directory option to /home/user/files or your chosen music directory. The rest can be left with default values.

  8. Click the Save Configuration and start CherryMusic button at the bottom of the page. The WebUI will refresh.

  9. You will be asked to enter an admin username and password. This account will have full control to create non-admin user accounts that can be used for friends/family.

  10. In SSH, hit Ctrl-a followed by d to detach from the CherryMusic screen window while leaving it running.

Usage

  • Click the menu in the top right corner to the options, including keyboard shortcuts. Admin users can also create new users and force an update of the music library.

  • Stop CherryMusic by entering pkill cherrymusic in SSH

  • Start CherryMusic again by entering screen -dmS cherrymusic ~/cherrymusic/cherrymusic in SSH

  • Upgrade CherryMusic by stopping CherryMusic then entering cd ~/cherrymusic followed by git pull in SSH

  • If you need to access your CherryMusic screen window, enter screen -r cherrymusic in SSH