2020-01-04 21:16:10 -05:00
|
|
|
# CloudSonic Server
|
2016-02-24 18:28:23 -05:00
|
|
|
|
2020-01-04 21:23:24 -05:00
|
|
|
[](https://github.com/cloudsonic/sonic-server/actions)
|
2017-04-01 09:47:14 -04:00
|
|
|
[](https://goreportcard.com/report/github.com/cloudsonic/sonic-server)
|
2016-02-26 10:56:57 -05:00
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
**This is still a work in progress, and has no releases available**
|
2016-02-25 13:51:20 -05:00
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
CloudSonic is a music collection server and streamer, optmized to run on cheap VPS servers. It implements the
|
2017-04-03 00:16:21 -04:00
|
|
|
[Subsonic](http://www.subsonic.org) API
|
2016-02-24 18:28:23 -05:00
|
|
|
|
2016-02-24 19:23:04 -05:00
|
|
|
The project's main goals are:
|
2016-02-26 01:45:04 -05:00
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
- Be fully compatible with available [Subsonic clients](http://www.subsonic.org/pages/apps.jsp)
|
2016-03-25 00:04:22 -04:00
|
|
|
(actively being tested with
|
2020-01-04 21:16:10 -05:00
|
|
|
[DSub](http://www.subsonic.org/pages/apps.jsp#dsub),
|
|
|
|
|
[SubFire](http://www.subsonic.org/pages/apps.jsp#subfire) and
|
|
|
|
|
[Jamstash](http://www.subsonic.org/pages/apps.jsp#jamstash))
|
|
|
|
|
- Import and use all metadata from iTunes, so that you can optionally keep using iTunes to manage your music
|
|
|
|
|
- Implement Smart Playlists, as iTunes
|
|
|
|
|
- Help me learn Go ;) [](https://golang.org)
|
2016-02-24 18:28:23 -05:00
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
### Supported Subsonic API version
|
2016-02-29 14:16:51 -05:00
|
|
|
|
2016-03-21 17:30:58 -04:00
|
|
|
I'm currently trying to implement all functionality from API v1.8.0, with some exceptions.
|
2016-03-10 12:03:08 -05:00
|
|
|
|
2017-04-01 09:47:14 -04:00
|
|
|
Check the (almost) up to date [compatibility chart](https://github.com/cloudsonic/sonic-server/wiki/Compatibility) for what is working.
|
2016-02-24 18:28:23 -05:00
|
|
|
|
2016-03-31 22:28:33 -04:00
|
|
|
### Installation
|
|
|
|
|
|
2017-04-01 09:47:14 -04:00
|
|
|
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
|
2016-03-31 22:28:33 -04:00
|
|
|
Development Environment section below, then run it with:
|
2020-01-04 21:16:10 -05:00
|
|
|
|
2016-03-31 22:28:33 -04:00
|
|
|
```
|
2017-04-01 09:47:14 -04:00
|
|
|
$ export SONIC_MUSICFOLDER="/path/to/your/iTunes Library.xml"
|
2020-01-04 21:16:10 -05:00
|
|
|
$ make run
|
2016-03-31 22:28:33 -04:00
|
|
|
```
|
2020-01-04 21:16:10 -05:00
|
|
|
|
2016-10-10 19:59:00 -04:00
|
|
|
The server should start listening on port 4533.
|
2016-03-31 22:28:33 -04:00
|
|
|
|
2016-02-26 11:39:14 -05:00
|
|
|
### Development Environment
|
|
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
You will need to install [Go 1.13](https://golang.org/dl/)
|
2016-02-29 14:16:51 -05:00
|
|
|
|
2016-02-26 11:39:14 -05:00
|
|
|
Then install dependencies:
|
2020-01-04 21:16:10 -05:00
|
|
|
|
2016-02-26 11:39:14 -05:00
|
|
|
```
|
2016-10-10 20:27:09 -04:00
|
|
|
$ make setup
|
2020-01-04 21:16:10 -05:00
|
|
|
```
|
2016-02-26 11:39:14 -05:00
|
|
|
|
2016-10-10 20:27:09 -04:00
|
|
|
Some useful commands:
|
2016-02-26 11:39:14 -05:00
|
|
|
|
2016-02-27 03:35:01 -05:00
|
|
|
```bash
|
|
|
|
|
# Start local server (with hot reload)
|
2016-10-10 20:27:09 -04:00
|
|
|
$ make run
|
2016-02-27 03:35:01 -05:00
|
|
|
|
2016-02-29 14:16:51 -05:00
|
|
|
# Run all tests
|
2016-10-10 20:27:09 -04:00
|
|
|
$ make test
|
2016-02-27 03:35:01 -05:00
|
|
|
```
|
2016-02-26 11:39:14 -05:00
|
|
|
|
2016-03-13 12:33:40 -04:00
|
|
|
### Copying
|
2016-02-24 18:28:23 -05:00
|
|
|
|
2020-01-04 21:16:10 -05:00
|
|
|
CloudSonic - Copyright (C) 2017-2020 Deluan Cotts Quintao
|
2016-02-23 18:41:35 -05:00
|
|
|
|
2017-04-01 09:21:55 -04:00
|
|
|
The source code is licensed under GNU Affero GPL v3. License is available [here](/LICENSE)
|