sox.js

A wrapper around SoX. Transcode audio files easily!

Examples

Simple transcode:

var sox = require('sox.js')
sox({
	inputFile: 'song.wav',
	outputFile: 'song.flac'
})

Lower volume:

var sox = require('sox.js')
sox({
	input: { volume: 0.8 },
	inputFile: 'song.flac',
	outputFile: 'song2.flac'
}, function done(err, outputFilePath) {
	console.log(err) // => null
	console.log(outputFilePath) // => song2.flac
})

Transcode with options and effects:

var sox = require('sox.js')
sox({
	soxPath: 'C:\\Program Files (x86)\\sox-14-4-2\\sox.exe',
	inputFile: 'song.ogg',
	output: {
		bits: 16,
		rate: 44100,
		channels: 2
	},
	outputFile: 'song.wav'
	effects: 'phaser 0.6 0.66 3 0.6 2 −t'
}, function done(err, outputFilePath) {
	console.log(err) // => null
	console.log(outputFilePath) // => song.wav
})

API

var sox = require('sox.js')

sox(options, [cb])

• options object required - The following parameters are supported:
  • soxPath string optional - The path to SoX. E.g. 'C:\Program Files\Sox\sox.exe'. Defaults to 'sox', which works if the SoX binary is in your path.
  • errOnStderr boolean optional - SoX sometimes logs warnings to stderr. By default, sox.js will call the callback with an error. If you set this to false, then the errors will be passed along to process.stderr, and the callback will not be called with an error. Defaults to true.
  • global object optional - Global SoX options
  • inputFile string required - The file path of the input file
  • outputFile string required - The file path of the output file
  • input object optional - These options will be used to interpret the incoming stream.
  • output object optional - These options will be used to format the outgoing stream. When an output option isn't supplied, the output file will have the same format as the input file where possible.
  • effects string|array of strings/numbers optional
• cb(err, outputFilePath) function optional - A function that is called when the conversion process is complete. If omitted, errors are thrown. The function is passed the following parameters:
  • err null|Error
  • outputFilePath string|undefined - A string of the outgoing file path, or undefined if an error occurred. E.g. 'song.flac'.

options object

An object of options. Every option is optional except options.inputFile and options.outputFile.

If you want an exhaustive list of each option in depth, take a look at the SoX documentation.

Internally, these options are transformed into the command-line arguments passed to a SoX child process.

options.inputFile / options.outputFile string, required

A file path, like './song.wav'.

options.global object|array of strings/numbers

You can supply an array of strings/numbers, or an object that will be transformed into an array of strings/numbers using hash-to-array.

Currently, sox.js only supports one input file.

sox({
	global: {
		buffer: 4096,
		norm: true,
		'single-threaded': true
	},
	output: { type: 'ogg' }
}, cb)

options.input / options.output object|array of strings/numbers

You can supply an array of strings/numbers, or an object that will be transformed into an array of strings/numbers using hash-to-array.

sox({
	input: [
		[ '--volume', 1.1 ],
		[ '--endian', 'big' ],
		[ '--no-glob' ]
	],
	output: { type: 'ogg' }
}, cb)
// same as
sox({
	input: {
		volume: 1.1,
		endian: 'big',
		'no-glob': true
	],
	output: [
		'--type', 'ogg'
	]
}, cb)
// same as
sox({
	input: '--volume 1.1 --endian big --no-glob',
	output: '--type ogg'
}, cb)

options.effects string|array of strings/numbers/arrays

Please see the SoX Documentation on Effects to see all the options.

You can put strings/numbers into sub-arrays, which will be flattened internally.

Pass them into sox.js like this:

sox({
	input: { type: 'ogg' },
	output: { type: 'wav' },


	effects: 'speed 1.5 swap'
	// same as
	effects: [
		'speed 1.5 swap'
	]
	// same as
	effects: [
		'speed', 1.5,
		'swap'
	]
	// same as
	effects: [
		[ 'speed', '1.5' ],
		'swap'
	]
}, cb)

Install

• Install SoX. You can download it, or you can do apt-get install sox.
• Install this package with npm: npm install sox

Test

To run the tests, you must also have SoX in your PATH. Then run: npm test

I run the tests using SoX 14.4.2, but other versions of SoX should work fine.

Codec Support

FLAC

• Problem: FLAC was disabled accidentally in 14.4.1. [Stack Overflow]
• Solution: Install SoX 14.4.2.

MP3

• Problem: MP3 is proprietary.
• Solution: Compile the LAME encoder, and/or the MAD decoder.
• Links:
  • Windows (Precompiled)
  • Windows (How-To)
  • Ubuntu (How-To)
  • Ubuntu (How-To) 2
  • CentOS (How-To)

License

MIT