bgamari / cherrymusic

Stream your own music collection to all your devices! The easy to use free and open-source music streaming server.

CherryMusic

CherryMusic is a music streaming server based on CherryPy and jPlayer. It plays the music inside your PC, smartphone, tablet, toaster or whatever device has a HTML5 compliant browser installed.

current features:

• stream your music inside the browser (locally or remote)
• browse and search your music
• completely AJAX based (no page reloads on click, therefore fast)
• create and share playlists
• multiple user authentication
• HTTPS support
• automatic album cover art fetching
• see CHANGES for all the features

You can find more information on the CherryMusic website and in our wiki.

master:

devel:

Getting Started

See the Setup Guide for quickstart instructions and more.

Basically, you can just

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

and then start the server and follow the instructions:

$ python cherrymusic --setup --port 8080

(Leave out the --options for subsequent starts.)

Requirements

• Python >= 2.6, >= 3.2 preferred
• CherryPy >= 3

More

See our wiki for user and developer information.

Troubleshooting

Please see the Troubleshooting wiki page.

Contribute

There's also a wiki section listing the 101 ways to lend a hand.