Command Line Options
Sockso has some extra command line options you can use to change the
way it works. You pass these commands to Sockso by running it from the
command line and with these options after the startup file (windows.bat
Disables the GUI, this can be used to run Sockso on a server. You will
be presented with a console to manage Sockso. Type help for a
full list of the commands.
Tells Sockso where to store/look for all it's data. This can be used to to
make Sockso portable for instance, by setting the data directory to wherever
you want it to be. The (default) HSQLDB stores its data here, and cached cover
Enable UPNP automatic port forwarding. On startup Sockso will try
to forward the correct port from your UPNP enabled router. This
requires the optionals package.
Sets the type of messages Sockso will output. "default" is the default and
just produces the usual information about what Sockso is doing. "dev" can
be used to provide much more detailed information.
Tell Sockso a fixed IP address to use (by default it'll try and work it
Here you can specify the language to use for the management interface (through
the web interface Sockso will pick the language according to that specified
by the users browser).
Specifies to run a query on the database and output the results as XML instead
of starting Sockso. You can specify a file to read the SQL from, or Sockso
will try to read the SQL from stdin.
This will tell Sockso whether to load it's resources from the jar file, or look
on the filesystem in the resources folder (default).
Run Sockso using HTTPS instead of HTTP.
Specifies the location of a keystore to use for SSL
Specifies a password for the SSL keystore
The type of database to use. The MySQL and SQLite database require the
--dbhost=(DNS or IP)
The host for the database server
Database user's password
Name of the database to use
Prints out information about the command line options.
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.