Swave NPM | npm.io

Swave

Swave is a Javascript audio player library with waveform visualization.

Live Demo: https://bogdan-cornianu.github.io/swave/examples/

Installation

npm install swave

Usage

let swave = new Swave({audioUrl: 'url...'});
swave.play();

Swave uses Web Audio APIs for visualizations, HTMLAudioElement for audio streaming and a Canvas element to draw the sound bars.
The first argument of the constructor is the html element where the canvas should be drawn.
The second argument is a configuration object:

audioUrl: required, the url for the audio to be played
autoPlay: false by default
crossOrigin: "anonymous" by default
showControls: false by default. If enabled, will display the audio element's playback controls

Swave exposes several methods which you can use to build an audio player:

play(): starts playing the audio
stop(): stops playing the audio
pause(): pauses the current playing audio
setVolume(number): values between 0.1 and 1
enableVisualization(HTMLElement): shows the sound bars
disableVisualization(): hides the sound bars
getDuration(): the length of the audio, in seconds
setCurrentTime(number): set the current time of the audio
getCurrentTime(): get the time of the audio as it plays
changeAudio(string): the new url of the audio

Contributing

If you find any bugs or have ideas of how Swave can be improved, please open an issue at https://github.com/bogdan-cornianu/swave/issues
If you would like to contribute code please have a look at our open issues, pick something you like and have fun :)