lameworker

LAME worker

Package for running LAME in a Web Worker. LAME makes it easy to encode and decode MP3 files. See example.html for an example that records audio from the microphone and encodes it as MP3 in real-time, then lets the user download it.

Example

Using this library is very simple. Assuming you have an HTML file with lame.js and lame.worker.js in the same directory, you can do the following:

<script src="lame.js"></script>
<script>
var lame = lameworker();
lame.getVersion(function (error, version) {
  console.log('Using LAME v' + version);
});
</script>

See dist/example.html for a full example.

Using with Browserify etc.

If you're using a toolchain that simulates a CommonJS environment, you can import this package instead of using the global from dist/lame.js:

var lameworker = require('lameworker');

// Note that you still need to refer to a stand-alone worker file.
var lame = lameworker('/static/lame.worker.js');

lame.getVersion(function (error, version) {
  console.log('Using LAME v' + version);
});

You can find the stand-alone worker file as dist/lame.worker.js in this package.

TODO

There are some obvious improvements to be done still:

1. Keep buffers within the Web Worker and only send back a Blob instance once the encoding is complete
2. Simpler API with a helper on the main thread side to make encoding MP3 just a couple of API calls
3. When the main thread sends data to the Web Worker, transfer the buffer instead of cloning it
4. More? Please add issues to this repository!

Building

Make sure you have Emscripten set up on your system, then run make.