“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

8th February 2010

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.

2nd May

Sockso 1.1.8 - Bug fixes for 'connection closed' issue.

19th February

Sockso 1.1.7 - Bug fixes for MySQL, reduced CPU usage with toggleable buffering options when streaming, and removed remaining hard coded text from web interface.

19th January

Sockso 1.1.6 - Bug fixes for indexing and properties, a smarter 404 page, updated german translation, and upgraded to jQuery 1.3

11th January

Sockso 1.1.5 - Bug fixes for MySQL backend, and some javascript issues.

4th January 2009

Sockso 1.1.4 - Bug fixes for searching and logging in / uploading. Added unpacked javascript, restyled album and artist pages to better fit long names (and added a new 'JS Player' - unstable).

7th December

Sockso 1.1.3 - Bug fixes.

25th November

Sockso 1.1.2 - Fixed file uploading (hopefully all platforms).

20th October

Sockso 1.1.1 - Added french translation, ability to scan collection on demand, and fixed bugs with --datadir, indexing Ogg files, a missing image, and the name of the scrobble log.

7th October

Sockso 1.1 - MySQL and (some) SQLite support added, Sockso is now more easily customizable, new WMA to MP3 encoding option.

19th September

Sockso 1.0.9 - Added SSL support, streaming can now require authentication, users can get their scrobble log for tracks they've listened to, added a new flash player, fixed some bugs.

6th September

Sockso 1.0.7 - Add 'related artists' information to pages, improved unicode support and fixed Windows indexing bug (hidden folders now ignored)

30th July

Sockso 1.0.6 - Bug fix release for problems losing colors when resizing local cover art.

27th July

Sockso 1.0.5 - Added resizing of user artwork, random playing of artists/albums, ability to import playlists, fixed imageflow squashing bug, dutch and german translations, and informs user if new versions are available.

Linux Logo Windows Logo OSX Logo

Smutty Logo