Setting up Netbeans
This page describes how to set up Sockso with Netbeans.
Creating the Project
After you have cloned the Git repository, open Netbeans and choose to create a new project
from existing sources.
Next, enter the name for the project (probably 'Sockso'), and choose the directory that
you cloned the repository in.
NOTE: You will probably get an error here about the build.xml file already
existing (Sockso uses its own, not Netbeans standard one) - so you will need to temporarily
rename build.xml to something else. But name it back when we have passed this step!
Then add the main source code folders...
And just click Finish, you don't need to go on to the next step, and your project
should be created for you...
The first thing you'll see is lots of errors on the packages like in the screenshot below.
This is because we haven't told Netbeans about all the dependencies yet, so right click the
Sockso project and select the Properties option from the menu.
Then we can go to the Libraries tab on the left side, and then click the button
labelled Add JAR/Folder.
We then need to add all the .jar files from the following folders...
- lib/dev (development)
- lib/opt (optional)
- lib/std (standard runtime libraries)
After this most of the errors will have gone, but you may still see errors about missing
template classes like in the screenshot below...
These classes (along with Sockso.java) are created when you build Sockso, so go to the
shell, change to the Sockso directory and run the compile Ant target. (You can also do this from
within Netbeans if you have the Ant plugin)
$> ant compile
The reason you need to do this is because all Sockso's output templates are written using
the Jamon templating engine (ie. all the .jamon files), which are converted to Java classes
and then compiled into Sockso. So running the compile target as above will do all this.
Normally though you won't run the compile target directly, you'll usually just use run
If you love using Sockso and would like to give a little back,
try a donation to help out and support open source development.
Latest News & Releases
Bug fix release - fixes broken folder browsing and related artists.
Bug fix for broken local cover art, and updated French translation.
14th March 2012
Bug fixes for path security hole, API access, and encoded pluses. Along with updated Italian translation,
adding ability to extract cover art from ID3 tags.
Added ability to add arbitrary meta tags, JPlayer support, HTTP Range header support, bug fixes, and finalised API v1.0
Fix for fetching cover artwork from Amazon.
Fixes for unicode output issue, and strict JSON API issue with single quotes.
Added a JSON API to support developing
applications on top of Sockso.
Posted screencast of *VERY* early
version of new Sockso iPhone app. Feedback appreciated in the forums.
Fix for problem on OSX where Sockso would not start, other minor bug fixes for Flac handling.
New HTML5 Player for iPad/iOS/etc support from nguillaumin,
new 'tinygreen' skin from Simplify, and some bug fixes.
Album years now shown, Turkish translation added, and MP3 tag library updated (all thanks to badZeppelin!),
some bug fixes to ajax page loading.
Users can now require approval when registering, and updated ajaxified web interface with embedded player now default.
Fix for missing 'colscan' command from console, moved optional libraries location (to upgrade rename
your optionals folder from 'lib-opt' to 'lib/opt', and a bug fix for invalid URL characters
breaking some playlist files.
Created ability to add servers to the new Sockso Community,
and you can now run behind Apache without needing a VirtualHost (thanks to LightGlitch!)
30th January 2011
Sockso 1.2.6 (broken)
Fix for selecting the playlist in some browsers, and added new web admin console.
Minor bug fix for adding items to the playlist when browsing folders.
Patches from Will to improve HTTP/HTTPS streaming performance, and HTML compliance, improved
music tree in GUI to cope with any size collections, hidden files now ignored on indexing,
and some other bugs.
Fixed broken 1.2.2 release.