Customizing Sockso!
If you'd like to change how Sockso looks for your users, this page explains
what you need to know. It's pretty simple to get started, so read this short
guide and you should be ready to get going!
1 - Resources
All the resources (images, css, etc...) that Sockso uses can be found in the
resources folder in the main directory. Inside that folder you'll see
a structure like this:
sockso
resources
htdocs
icons
images
locales
(If you're on OSX and want to customize Sockso it's easiest to download
the linux version)
2 - Understanding the folders
The first folder htdocs is probably going to be the most interesting
one when customizing Sockso. This folder contains all the CSS, Javascript and
images used in the web interface. Just get in there and start playing around!
The icons and images folders contain the icons and images that
are used by the GUI. The locales folder contains translation text used
by Sockso for displaying different languages. The files are named sockso.LANG_CODE.txt,
where LANG_CODE is the correct language code.
With that information you should be able to play around with the images and
the CSS and make your Sockso look however you like!
3 - Skins
Sockso usesskins to display different designs
for the web interface, and which one is used can
be set with the property www.skin. These are stored in the skins
folder inside htdocs. By default Sockso uses the "original"
skin, so you'll see a bunch of files and folders in there for it.
If you want to add your own skin, just create a new folder for it inside
the htdocs/skins folder, then create the file css/default.css. You're now
set to change the styling all you need, and switch between this skin and others.
4 - Sharing your design
So now you have your new design, you may want to be able to share it with
other Sockso users. If you've created a new skin for the web interface then sharing
will be as easy as sending that folder to someone! They can then copy it into
their htdocs/skins folder and switch theirskin
using the www.skin property.
You can post your custom resources files online, maybe on the Sockso
custom resources forum!
4 - Hacking Sockso
If you'd like to go one step further and really get into changing Sockso you're
going to need to start hacking the code. Get over to the source code
page and grab yourself a copy!
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 
12th May
Sockso 1.5.3
-
Bug fix release - fixes broken folder browsing and related artists.
29th April
Sockso 1.5.2
-
Bug fix for broken local cover art, and updated French translation.
14th March 2012
Sockso 1.5.1
-
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.
10th December
Sockso 1.5
-
Added ability to add arbitrary meta tags, JPlayer support, HTTP Range header support, bug fixes, and finalised API v1.0
25th July
Sockso 1.4.2
-
Fix for fetching cover artwork from Amazon.
24th July
Sockso 1.4.1
-
Fixes for unicode output issue, and strict JSON API issue with single quotes.
23rd July
Sockso 1.4
-
Added a JSON API to support developing
applications on top of Sockso.
8th July
Posted screencast of *VERY* early
version of new Sockso iPhone app. Feedback appreciated in the forums.
2nd July
Sockso 1.3.5
-
Fix for problem on OSX where Sockso would not start, other minor bug fixes for Flac handling.
26th June
Sockso 1.3.4
-
New HTML5 Player for iPad/iOS/etc support from nguillaumin,
new 'tinygreen' skin from Simplify, and some bug fixes.
4th May
Sockso 1.3.3
-
Album years now shown, Turkish translation added, and MP3 tag library updated (all thanks to badZeppelin!),
some bug fixes to ajax page loading.
2nd April
Sockso 1.3.2
-
Users can now require approval when registering, and updated ajaxified web interface with embedded player now default.
23rd March
Sockso 1.3.1
-
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.
17th March
Sockso 1.3
-
Created ability to add servers to the new Sockso Community,
and you can now run behind Apache without needing a VirtualHost (thanks to LightGlitch!)
5th February
Sockso 1.2.7
-
Fix for broken javascript in 1.2.6.
30th January 2011
Sockso 1.2.6 (broken)
-
Fix for selecting the playlist in some browsers, and added new web admin console.
17th December
Sockso 1.2.5
-
Minor bug fix for adding items to the playlist when browsing folders.
10th April
Sockso 1.2.4
-
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.
8th February
Sockso 1.2.3
-
Fixed broken 1.2.2 release.
Comments