🎧☁️ Modern Music Server and Streamer compatible with Subsonic/Airsonic
Go to file
Deluan 0a56fd8752 Add Makefile target to start ginkgo in watch mode 2020-01-15 23:40:22 -05:00
.github/workflows Add JS tests/build to pipeline. Removed invalid test 2020-01-15 13:02:17 -05:00
api Add extension to snapshots files (make it easier to format them for visualization) 2020-01-15 18:03:22 -05:00
bin Removed unused scripts (moved to Makefile) 2016-10-10 21:03:21 -04:00
conf Add flag to disable startup banner 2020-01-15 17:51:52 -05:00
engine Fix test suite name 2020-01-15 21:52:50 -05:00
itunesbridge Playlists support (99%) complete! 2016-03-24 13:28:20 -04:00
log Allow LogLevel to be configurable. Also add filename and line number when LogLevel>=debug 2020-01-13 19:57:36 -05:00
model Add GetGenre endpoint 2020-01-15 17:56:02 -05:00
persistence Add GetGenre endpoint 2020-01-15 17:56:02 -05:00
scanner_legacy Change semantics of ChecksumRepository 2020-01-15 08:54:00 -05:00
server Add flag to disable startup banner 2020-01-15 17:51:52 -05:00
static Implemented getAvatar 2016-03-21 20:31:28 -04:00
tests Change default db path 2020-01-14 18:55:12 -05:00
ui Add JS tests/build to pipeline. Removed invalid test 2020-01-15 13:02:17 -05:00
utils Remove Portuguese word, to avoid misspell errors 2020-01-15 15:35:04 -05:00
.gitignore Change default db path 2020-01-14 18:55:12 -05:00
.nvmrc Add ui subfolder, bootstrapped a "hello-world" React-Admin app, changed Makefile to start both apps in dev mode 2020-01-14 15:34:59 -05:00
LICENSE Changing license 2017-04-01 09:21:55 -04:00
Makefile Add Makefile target to start ginkgo in watch mode 2020-01-15 23:40:22 -05:00
Procfile.dev Add ui subfolder, bootstrapped a "hello-world" React-Admin app, changed Makefile to start both apps in dev mode 2020-01-14 15:34:59 -05:00
README.md Update README.md 2020-01-13 17:31:12 -05:00
go.mod Bump github.com/lib/pq from 1.1.1 to 1.3.0 2020-01-15 08:56:33 -05:00
go.sum Bump github.com/lib/pq from 1.1.1 to 1.3.0 2020-01-15 08:56:33 -05:00
main.go Add startup banner 2020-01-13 18:24:54 -05:00
reflex.conf Add ui subfolder, bootstrapped a "hello-world" React-Admin app, changed Makefile to start both apps in dev mode 2020-01-14 15:34:59 -05:00
wire_gen.go Simplify persistence injection 2020-01-15 17:56:02 -05:00
wire_injectors.go Simplify persistence injection 2020-01-15 17:56:02 -05:00

README.md

CloudSonic Server

Build Status Go Report Card

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. Currently it can only import iTunes libraries, but soon it will also be able to scan any folder with music files.

Version 1.0 main goals are:

  • Be fully compatible with available Subsonic clients (actively being tested with DSub, Music Stash and Jamstash)
  • Import and use all metadata from iTunes, so that you can optionally keep using iTunes to manage your music
  • 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/iTunes Library.xml"
$ 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

CloudSonic - Copyright (C) 2017-2020 Deluan Cotts Quintao

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