Wiki > CherryMusic

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

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 26275 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 26275
   

6. Open http://server.whatbox.ca:26275 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