“A personal music server
for everyone”

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 uses skins 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 their skin 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 RSS Icon

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.

7th February 2010

Sockso 1.2.2 (BROKEN) - Users can now change their passwords via the web interface, added property to disable checking for the latest version, new manual scheduler, and bug fixes for quotes in track names and amazon cover fetching.

30th December

Sockso 1.2.1 - New cron scheduling support for collection scanning, streaming improvement (by mrave), and added palm pre support.

26th September

Sockso 1.2 - New faster track indexing, AAC support (by mrave), CPU usage improvements, updated Dutch translation, lots of other fixes.

Linux Logo Windows Logo OSX Logo

Smutty Logo