🎧☁️ Modern Music Server and Streamer compatible with Subsonic/Airsonic
Go to file
Deluan dc98b187d9 Upgrades all dependencies 2017-04-01 11:16:14 -04:00
api Upgrades to Beego v1.8.0 2017-04-01 10:59:31 -04:00
bin Removed unused scripts (moved to Makefile) 2016-10-10 21:03:21 -04:00
conf Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
controllers Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
domain Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
engine Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
init Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
itunesbridge Playlists support (99%) complete! 2016-03-24 13:28:20 -04:00
persistence Fixes typo 2017-04-01 09:55:21 -04:00
scanner Changes to itl were merged, reverting to the original repo 2017-04-01 09:51:25 -04:00
static Implemented getAvatar 2016-03-21 20:31:28 -04:00
tasks Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
tests Upgrades to Beego v1.8.0 2017-04-01 10:59:31 -04:00
utils Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
vendor Upgrades all dependencies 2017-04-01 11:16:14 -04:00
.gitignore Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
.travis.yml Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
LICENSE Changing license 2017-04-01 09:21:55 -04:00
Makefile Adding a Makefile 2016-10-10 20:27:09 -04:00
README.md Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00
main.go Renamed project to CloudSonic 2017-04-01 09:47:14 -04:00

README.md

CloudSonic Server

Build Status Go Report Card

This is still a work in progress, and has no releases available

CloudSonic is an application that implements the Subsonic API, but instead of having its own music library like the original Subsonic application, it interacts directly with your iTunes library.

The project's main goals are:

  • Be fully compatible with available Subsonic clients (actively being tested with DSub, SubFire and Jamstash)
  • Use all metadata from iTunes, so that you can keep using iTunes to manage your music
  • Keep iTunes stats (play counts, last played dates, ratings, etc..) updated, at least on Mac OS X. This allows smart playlists to be used in Subsonic Clients
  • Help me learn Go ;) Gopher

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"
$ bee run

The server should start listening on port 4533.

Development Environment

You will need to install Go 1.7

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 Deluan Cotts Quintao

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