*UNMAINTAINED* JavaScript library to record audio in browsers as used in the SoundCloud Javascript SDK.
JavaScript ActionScript CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.




Recorder.js is a JavaScript library to simply record audio in the browser. Currently the recording functionality is backed by Adobe Flash but will extended to open standards as soon as they are being adopted.

Getting started

  • Copy these 2 files somewhere into your website directory:
    • recorder.js
    • recorder.swf
  • Add the script to your HTML: <script type="text/javascript" src="path/to/recorder.swf"></script>
  • Use the Recorder object to initialize and record (see usage... :)




The Recorder needs to be initialized. Usage:

    swfSrc: "./recorder.swf"                                  // URL to recorder.swf
    // optional:
    flashContainer: document.getElementById("somecontainer"), // (optional) element where recorder.swf will be placed (needs to be 230x140 px)
    onFlashSecurity: function(){                              // (optional) callback when the flash swf needs to be visible
                                                              // this allows you to hide/show the flashContainer element on demand.

If flashContainer and onFlashSecurity is not passed as options an invisible DIV element including the Recorder.swf will be inserted at the end of the BODY and will be displayed centered in the screen when necessary.


Will start recording audio until Recorder.stop() is called. Adobe Flash will ask the user for permission to access the microphone unless it was already given before. If thats the case the onFlashSecurity callback from the initialization will be called. Once the actual recording starts an onRecording callback that you can pass to as an option will be called.


    start: function(){                 // will be called when the recording started 
                                       // which could be delayed because Adobe Flash asks the user for microphone access permission
    progress: function(milliseconds){  // will be called in a <1s frequency with the current position in milliseconds


Will play the recorded audio. Usage:

    finished: function(){               // will be called when playback is finished
    progress: function(milliseconds){  // will be called in a <1s frequency with the current position in milliseconds


Will stop the current recording or playing.


Will initiate a multipart POST (or PUT) to upload the recorded audio. Usage:

    method: "POST"                             // (not implemented) (optional, defaults to POST) HTTP Method can be either POST or PUT 
    url: "http://api.soundcloud.com/tracks",   // URL to upload to (needs to have a suitable crossdomain.xml for Adobe Flash)
    audioParam: "track[asset_data]",           // Name for the audio data parameter
    params: {                                  // Additional parameters (needs to be a flat object)
      "track[title]": "some track",
      "oauth_token":  "VALID_TOKEN"
    success: function(responseText){           // will be called after successful upload
    error: function(){                  // (not implemented) will be called if an error occurrs
    progress: NULL                      // (not yet implemented)