| .github/workflows | ||
| api | ||
| bin | ||
| conf | ||
| controllers | ||
| domain | ||
| engine | ||
| itunesbridge | ||
| persistence | ||
| scanner | ||
| static | ||
| tests | ||
| utils | ||
| .gitignore | ||
| app.go | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| main.go | ||
| Makefile | ||
| mime_types.go | ||
| README.md | ||
| wire_gen.go | ||
| wire_injectors.go | ||
CloudSonic Server
This is still a work in progress, and has no releases available
CloudSonic is a music collection server and streamer, optmized to run on cheap VPS servers. It implements the Subsonic API
The project's main goals are:
- Be fully compatible with available Subsonic clients (actively being tested with DSub, SubFire and 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 ;)
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