2.5 KiB

Raw Blame History

CloudSonic Server

CloudSonic is a music collection server and streamer, allowing you to listen to your music collection from anywhere. It relies on the huge selection of available mobile and web apps compatible with Subsonic, Airsonic and Madsonic

It is already functional (see Installation below), but still in its early stages.

Version 1.0 main goals are:

Be fully compatible with available Subsonic clients (actively being tested with DSub, Music Stash and Jamstash)
Implement smart/dynamic playlists (similar to iTunes)
Optimized ro run on cheap hardware (Raspberry Pi) and VPS

Supported Subsonic API version

I'm currently trying to implement all functionality from API v1.8.0, with some exceptions.

Check the (almost) up to date compatibility chart for what is working.

Installation

As this is a work in progress, there are no installers yet. To have the server running in your computer, follow the steps in the Development Environment section below, then run it with:

$ export SONIC_MUSICFOLDER="/path/to/your/music/folder"
$ make run

The server should start listening for requests. The default configuration is:

Port: 4533
User: anyone
Password: wordpass

To override this or any other configuration, create a file named sonic.toml in the project folder. For all options see the configuration.go file

Development Environment

You will need to install Go 1.13

Then install dependencies:

$ make setup

Some useful commands:

# Start local server (with hot reload)
$ make run

# Run all tests
$ make test

Copying

The source code is licensed under GNU Affero GPL v3. License is available here