Skip to content
Stream your own music collection to all your devices! The easy to use free and open-source music streaming server.
Python JavaScript HTML Other
Branch: devel
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
audiotranscode audio transcoding: force resampling to 44.1kHz when using OGG encoder, May 23, 2016
cherrymusicserver release 0.41.2 Feb 7, 2018
cmbootstrap cmbootstrap: made more clear whats the default option for downloading… Oct 9, 2017
devscripts Update jQuery to 3.2.1 Jul 21, 2017
doc Make user session duration configurable Mar 24, 2017
res reverted update of jPlayer Oct 10, 2017
tinytag updated tinytag to version 0.15.1, supports mp4 tags Jul 9, 2016
.gitignore exclude node_modules folder in gitignore Jul 9, 2016
.travis.yml Get faster travis build results Feb 4, 2018
CHANGES release 0.41.2 Feb 7, 2018
COPYING closes #25 Aug 30, 2012 Update Feb 14, 2014 added automatic markdown to rst conversion for pypi release Sep 19, 2014 added script to automatically merge pot into po files and to compile … Dec 15, 2013
cherrymusic updated copyright to 2016 May 23, 2016
cherrymusic-tray cleaned up ressource folder Jan 19, 2014
cherrymusicd Update copyright years; some whitespace cleanup Jan 13, 2014
pre-commit Update copyright years; some whitespace cleanup Jan 13, 2014
runtests runtests: Use nosetest paths set in $TESTERS if exists Oct 26, 2014 Fixed 2.6.9 build fail (zero length format field) Oct 6, 2017


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: Build Status Master

devel: Build Status Devel

Getting Started

See the Setup Guide for quickstart instructions and more.

Basically, you can just

$ git clone git://

and then start the server and follow the instructions:

$ python cherrymusic --setup --port 8080

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



See our wiki for user and developer information.


Please see the Troubleshooting wiki page.


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

You can’t perform that action at this time.