Fork me on GitHub

“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:


(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 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 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!


  • RK said:
    Sockso is really good and very customizable. Too bad the forum is down... :(
    2017-04-12 19:01:35

Post Comment

Just enter your name, fill out the easy captcha and enter your comments - it'll appear on the site right away. If you enter your email it will just be linked from your name so people can get in touch with you about your comment, so it's optional.

Sockso Community!

Sockso comes with the ability to be instantly part of the Sockso Community. So install now to to take part!

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

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.

Linux Logo Windows Logo OSX Logo