deluan/iSonic – GitClassic

📄 README.md

iSonic ======

THIS PROJECT IS HALTED.

I started this project as a means to learn new stuff. But Java, Spring-Boot, Solr/Lucene and Gradle are not really new to me... So I rebooted this project as a Go project. The new project, GoSonic, can be found here: https://github.com/deluan/gosonic

About

iSonic 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 main goals for this project are:

Full compatibility with the available Subsonic clients
Use all metadata from iTunes
Update play counts, last played dates, ratings, etc.. on iTunes
Use iTunes interface to manage your music

Building and running

You will need Java 1.7 to build and run this application. This is a Spring Boot project, using Gradle as its build tool. The easiest way to run the app from the sources is using the Gradle wrapper with the bootRun task:

$ ./gradlew bootRun

 _  ______             _
(_)/ _____)           (_)
 _( (____   ___  ____  _  ____
| |\____ \ / _ \|  _ \| |/ ___)
| |_____) ) |_| | | | | ( (___
|_(______/ \___/|_| |_|_|\____)
http://github.com/deluan/iSonic

....... . . .
....... . . . (log output here)
....... . . .
........ Started ISonicApplication in 29.737 seconds (JVM running for 31.771)

You can check if it is running by pointing your browser to http://localhost:8080. You should view the message: Greetings from iSonic!

The first time you build it, Gradle will download all required dependencies (takes a looooong time). These will be cached for the subsequent builds.

This project can be package as a standalone JAR application with the following command:

$ ./gradlew build                        # to build it
$ java -jar build/libs/iSonic-X.X.X.jar  # to run it (use the current version instead of X.X.X)

Setup dev environment

Any good IDE with Gradle support should be able to open and build the project. Check Spring Boot documentation on [how to set-up hot swapping] (http://docs.spring.io/spring-boot/docs/1.2.0.RC2/reference/htmlsingle/#howto-reload-java-classes-without-restarting) so you don't need to restart the application after every change.