Skip to content
A Javascript library for working with Audio. It provides a consistent API for loading and playing audio on different browsers and devices. Currently supports WebAudio, HTML5 Audio, Cordova / PhoneGap, and a Flash fallback.
JavaScript CSS HTML ActionScript
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
_assets Updated NEXT libs and docs Sep 14, 2017
build Fixed https in doc assets Oct 16, 2017
dev/com/createjs/soundjs fixed issue 154, FlashAudioPlugin not properly setting volume and pan… Feb 25, 2015
docs Updated version naming Sep 15, 2017
examples Minor demo issues Oct 16, 2017
lib New libs with Sound 1.0 fix Oct 12, 2017
src Minor update to deprecated docs Mar 27, 2019
tutorials Updated https in tutorials Oct 16, 2017
.gitignore Added initial unit tests. Apr 6, 2015
.npmignore Added NPM support Sep 15, 2017 Create Dec 6, 2017
LICENSE.txt Changed LICENSE name Nov 4, 2014 Updates to VERSIONS, docs, and libs Jun 8, 2017
README_CREATEJS_NAMESPACE.txt Fixed a spelling mistake Aug 4, 2014
VERSIONS.txt New libs with Sound 1.0 fix Oct 12, 2017
bower.json Updated bower main to new renamed file Sep 28, 2017
icon.png Updated documentation + icon Dec 17, 2014
package.json Updated SoundJS version for NPM Oct 12, 2017


SoundJS is a library to make working with audio on the web easier. It provides a consistent API for playing audio in different browsers, including using a target plugin model to provide an easy way to provide additional audio plugins like a Flash fallback (included, but must be used separately from the combined/minified version).

A mechanism has been provided for easily tying in audio preloading to PreloadJS.


createjs.Sound.on("fileload", handleLoadComplete);
createjs.Sound.alternateExtensions = ["mp3"];
createjs.Sound.registerSound({src:"path/to/sound.ogg", id:"sound"});
function handleLoadComplete(event) {"sound");


Built by, and released for free under the MIT license, which means you can use it for almost any purpose (including commercial projects). We appreciate credit where possible, but it is not a requirement.

Support and Resources



The core API for playing sounds. Call, ...options), and a sound instance is created that can be used to control the audio, and dispatches events when it is complete, loops, or is interrupted.


A controllable sound object that wraps the actual plugin implementation, providing a consistent API for audio playback, no matter what happens in the background. Sound instances can be paused, muted, and stopped; and the volume, pan (where available), and position changed using the simple API.


The default, built-in plugin, which uses Web Audio APIs to playback sounds. Note that WebAudio will fail to load when run locally, and the HTML audio plugin will be used instead.


The fallback built-in plugin, which manages audio playback via the HTML5 tag. This will be used in instances where the WebAudio plugin is not available.


An additional plugin which will playback audio in a Cordova app and tools that utilize Cordova such as PhoneGap or Ionic. You must manually register this plugin. Currently available on github since SoundJS-0.6.1.


An additional plugin which uses a flash shim (and SWFObject) to playback audio using Flash. You must manually set up and register this plugin.

Documentation and examples

Have a look at the included examples and API documentation for more in-depth information.

You can’t perform that action at this time.