Fork me on GitHub

“A personal music server
for everyone”

Encoders

With Sockso, it's possible to use various different encoders when playing music. You probably want to do this for one of the following reasons...

  • Re-encode one format to another (eg. so Ogg files can be played with Sockso's flash player, which only support mp3s)
  • Re-encode music at a lower bitrate so it can be listened to on slower connections

The Encoders Panel

The encoders panel in Sockso lists the various file formats that Sockso can handle, and then allows you to specify how Sockso should handle each of these different types. The default is to stream the track unaltered.

Builtin Encoding

These are in the form of settings and/or scripts that come with Sockso that allow you to just select an option from the list and have your music encoded. You will need to have the correct programs installed on your computer though, Sockso just provides the means to use them. So for example if you want to use Lame to re-encode your mp3's at a lower bitrate, you'll need to have it installed and available in your PATH.

Custom Encoding

This option allows you to specify a command to use to re-encode your music. This will probably be in the form of a shell script which does whatever you want to the music before playing it. Whatever program you use, it should take the path of the track as its first argument, and return the audio data to stdout (Sockso will then read it back in and send it to the users music player).

Console

You can also set up encoding through the console by editing Sockso's properties. The properties live under the encoders prefix. Here's an example that will enable builtin Lame encoding for mp3's...

encoders.mp3 BUILTIN
encoders.mp3.name Lame
encoders.mp3.bitrate 128

So first you need to set the type of encoder for the file extension, this type can be either NONE, BUILTIN, or CUSTOM, eg...

encoders.mp3 NONE
encoders.ogg BUILTIN
encoders.flac CUSTOM

NONE

If the value for the file type is set to NONE, then the tracks of this type will be streamed completely unaltered.

encoders.wma NONE

BUILTIN

If set to BUILTIN, you'll then need to specify a name for the builtin encoder that you want to use. Currently the builtin encoders you can choose from are...

  • Lame - Re-encodes mp3's to a different bitrate.
  • OggDecToLame - Converts Ogg to mp3
  • FlacToLame - Convert FLAC to mp3
encoders.ogg BUILTIN
encoders.ogg.name OggDecToLame

CUSTOM

If you want to specify your own script (as explained above) to do the encoding then set this to CUSTOM, and use the command property to give the full command to run your script.

encoders.flac CUSTOM
encoders.flac.command /bin/sh /home/me/re-encode.sh

Comments

  • No comments yet, be the first!

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