navidrome/README.md

2.1 KiB

GoSonic

Build Status Go Report Card

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

GoSonic 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.

Development Environment

You will need to install Go 1.6

Then install dependencies:

$ go get github.com/beego/bee           # bee command line tool     
$ go get github.com/Masterminds/glide   # dependency manager
$ glide install

From here it's a normal BeeGo development cycle. Some useful commands:

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

# Run all tests
$ go test $(glide nv) -v

Copying

GoSonic - Copyright (C) 2016 Deluan Cotts Quintao

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