Skip to content

An easy to use and powerful Web Audio API wrapper for controlling audio on the web

License

Notifications You must be signed in to change notification settings

craigharvi3/audibly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

audibly

An easy to use and powerful Web Audio API OO wrapper for controlling audio on the web.

The Web Audio API provides a powerful and versatile system for controlling audio on the Web, allowing developers to choose audio sources, add effects to audio, create audio visualizations, apply spatial effects (such as panning) and much more. https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API

audibly looks to take all the wonderfullness that the Web Audio API offers and abstract it into a more intuitive and user friendly API.

Check our demo here

Node list

  • BufferSource
  • Oscillator
  • Filter
  • Reverb
  • Delay
  • Compressor
  • Gain
  • Panner

Usage

Include javascript file

<script type="text/javascript" src="audibly.min.js"></script>

You will then have access to all nodes listed above. To create a BufferSource node for example, you would call the following:

new Audibly.BufferSource({
  url: './audio/music-loop.wav',
  playbackRate: 1,
  loop: true
}).then( function( node ) {
    node.connect();
    node.start(0);
}, function( error ) {
  console.log(error)
} );

The BufferSource will return a promise - since it performs a http request to fetch the raw audio data. The promise success callback will return you the node to use - as shown here in the demo.

Building source

Clone the repo and perform the following commands inside the audibly directory:

Install node modules

make install

Build assets (also performs watch)

make dev

Fire up dev server

make serve

Your server will be up and running at http://localhost:8080/

Issues

We very much welcome collaborators so if you see any issues, file an issue here or create a PR and we'll review.

Enjoy!

About

An easy to use and powerful Web Audio API wrapper for controlling audio on the web

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published