Fork me on GitHub

“A personal music server
for everyone”


Sockso's behaviour is controlled mainly through the properties stored in the database. You have complete access to all these properties from the Sockso command line. To set a property you need to use the propset command. This takes the name of property and then the value you want to set it to. eg.

#SoCkSo#> propset www.title my new title

NOTE: There is no :!

The properties Sockso currently supports are:

Web Interface

www.title: text (main title on web interface)

www.tagline: text (smaller heading)

www.disableDownloads: yes/no

users.requireLogin: yes/no

users.requireActivation: yes/no

users.disableRegistration: yes/no

www.flashPlayer.dontFilterMp3s: yes/no (don't limit flash player to mp3's)

www.imageflow.disable: yes/no (disable imageflow)

www.similarArtists.disable: yes/no (disable similar artists)

www.covers.disable: yes/no (disable cover images)

www.covers.disableRemoteFetching: yes/no (disable fetching covers from internet) text (name of the skin)

www.metatags.*: arbitrary meta tags

Server ip address number (unix timestamp)

server.port: number

server.basepath: path


stream.requireLogin: yes/no (require auth for streaming, this requires users.requireLogin to be set to 'yes' as well)


uploads.enabled: yes/no (enables uploads)

uploads.requireLogin: yes/no (need login to upload?)

uploads.collectionId: number (collection id to store uploads in)


browse.folders.enabled: yes/no (enable folder browsing?)

browse.folders.only: yes/no (use folder browsing only?)

browse.popularTracks.count: number (how many popular tracks)

browse.topArtists.count: number (how many top artists)

browse.recentTracks.count: number (how many recent tracks)

browse.latestArtists.count: number (how many latest artists)

browse.latestAlbums.count: number (how many latest albums)

browse.latestTracks.count: number (how many latest tracks)


log.requests.enable: yes/no (enables request logging)


playlists.random.trackLimit: number (number of tracks in random playlists)


app.startMinimized: yes/no

app.confirmExit: yes/no


collman.scan.onStart: yes/no (scan collection on startup?)

collman.scan.interval: number (minutes between collection scans)

collman.artists.removePrefixes: text (commer seperated list of prefixes to remove)

NB: When setting prefixes to remove, if you only specify one you'll need to put a commer after it if it ends with a space eg. 'The ,'


covers.artist.file: text (file name of artist image)

covers.album.file: text

covers.cacheLocal: yes/no (cache local cover art?)

covers.defaultWidth: number (pixel width to resize images to)

covers.defaultHeight: number (pixel height to resize images to)

covers.xspf.display: album/artist (in XSPF, show artist or album artwork?)

covers.file.fallback: name of default image file to look for in each folder


version.checkDisabled: yes/no (disable checking for updates)


  • Narb Support said:
    @ Eddie, (this is an example:)

    Ive just made a redirection from subdomain "" to "" @ my webserver and using "" as address link in my sites.

    Offcourse my DNS server has a correct record that points the domain name to my server IP.

    If you have an domain name you will probably know how to make this DNS-record.

    A Simple way -> not the best is making a html page with following text:

    <html lang="en-US">
    <meta charset="UTF-8">
    <meta http-equiv="refresh" content="0;url=">
    <script type="text/javascript">
    window.location.href = ""
    <title>Redirect to</title>
    <!-- Note: don't tell people to `click` the link, just tell them that it is a link. -->
    Please folow this <a href=''>link</a> if you are not redirected.

    Greetz, Narb
    2014-01-25 23:30:57
  • eddie said:
    right now I'm using ip address to to access the website...can I use the domain name that I've created??

    2013-12-11 19:10:24
  • Armin bei said:
    Dear Manfred Baack.

    in the album folder i put one pic album.jpg and artist.jpg with the audio befor I scan the entry.
    If you scan the entry before you put the pic in the albumfolder with the audiodat , it create a coverpic from the internet.
    Open in C: ... Dokuments.. your pc-name
    the folder /.sockso the folder /cover.
    Open a new eplorerwindow with your musikfolders.
    Put in the folders of musik your album.jpg and artist.jpg if you like (ca.200x200pic)
    than go to the /.sockso/cover folder and del all the coverĀ“s in this folder.
    After this, sockso shows the artist und cover .jpg from the musikfolder.
    If the pics in musikfolder do not match, please edit the pic smaler.
    I hope with my "smal english" can help a smal one.

    Dear in JC
    2013-05-20 05:33:11
  • Manfred Baack said:
    I have set
    propset covers.artist.file _artist.jpg
    propset covers.album.file _cover.jpg
    propset www.covers.disableRemoteFetching yes

    It shall none are fetched to cover from the Internet.
    I would want that album cover and interpreter pictures only stored locally are shown.

    The interpreter picture is a folder in the subsequent Eden:
    \\Nas\RPJ-Interpr\Z\Zappa, Frank\_artist.jpg
    The album cover is a folder in the subsequent Eden:
    \\Nas\RPJ-Interpr\M\Madonna\2007 - Candy Shop\_cover.jpg

    Another interpreter picture than my _artist.jpg is nevertheless shown
    What do I have to do?
    2013-05-14 11:53:16

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