https://github.com/devsnd/cherrymusic

Stream your own music collection to all your devices! The easy to use free and open-source music streaming server.
https://github.com/devsnd/cherrymusic

Last synced: 4 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/devsnd/cherrymusic
• Owner: devsnd
• License: gpl-3.0
• Created: 2012-07-15T22:46:00.000Z (over 13 years ago)
• Default Branch: devel
• Last Pushed: 2024-06-26T10:13:23.000Z (over 1 year ago)
• Last Synced: 2025-09-27T11:14:56.123Z (6 months ago)
• Language: Python
• Homepage: http://www.fomori.org/cherrymusic
• Size: 7.49 MB
• Stars: 1,036
• Watchers: 66
• Forks: 185
• Open Issues: 112
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES
  • License: COPYING

Awesome Lists containing this project

• awesome-homelab - CherryMusic - source music streaming server. | (Apps / MediaManagement)

README

          
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](http://www.fomori.org/cherrymusic)

and in our [wiki](https://github.com/devsnd/cherrymusic/wiki).

master: [![Build Status Master](https://travis-ci.org/devsnd/cherrymusic.png?branch=master)](https://travis-ci.org/devsnd/cherrymusic)

devel: [![Build Status Devel](https://travis-ci.org/devsnd/cherrymusic.png?branch=devel)](https://travis-ci.org/devsnd/cherrymusic)

 

Getting Started

---------------

See the [Setup Guide](https://github.com/devsnd/cherrymusic/wiki/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](http://python.org/download/releases/) >= 2.6, >= 3.2 preferred

* [CherryPy](http://www.cherrypy.org) >= 3

More

----

See our [wiki](https://github.com/devsnd/cherrymusic/wiki) for user and developer information.

Troubleshooting

---------------

Please see the [Troubleshooting wiki page](https://github.com/devsnd/cherrymusic/wiki/Setup-Guide#wiki-troubleshooting).

Contribute

----------

There's also a wiki section listing the 

[101 ways to lend a hand](https://github.com/devsnd/cherrymusic/wiki/Contribute).