
wavesurfer.js
Open-source JavaScript library that renders interactive, customizable audio waveforms and plays audio in the browser.
wavesurfer.js draws an interactive waveform for an audio file inside a container element and plays the audio. Its options set the colors of the waveform and its playback progress. Official plugins add regions, a timeline, a minimap, envelope controls, recording, a spectrogram and a hover readout, and the package ships TypeScript types.
The wavesurfer.js guide covers common use cases, plugins and framework integration.
Worth knowing
Audio is decoded in the browser, so long clips can fail to decode for memory reasons. The FAQ recommends pre-decoded peaks for large files, and streaming audio needs them. Audio served from another domain must send CORS headers, or the browser will not fetch it.
Identity
- Status
- Active
- Maintainer
- katspaugh5
- Maintained by
- Individual
- First release
- 20136
Rendering and deploy
- Runs as
- In the browser3
- Install with
- npm, script tag3
Releases
Adoption
Sources
- 2026-11-17: links
wavesurfer.xyz/ - 2026-11-17: links, Written in, License, GitHub stars
api.github.com/repos/katspaugh/wavesurfer.js - 2026-11-17: links, Categories, Runs as, Install with
github.com/katspaugh/wavesurfer.js/blob/main/README.md - 2026-11-17: License
wavesurfer.xyz/about/ - 2026-11-17: Maintainer
github.com/katspaugh/wavesurfer.js/blob/main/LICENSE - 2026-11-17: First release
api.github.com/repos/katspaugh/wavesurfer.js/git/ref/tags/0.0.1 - 2026-11-17: Current major version, Last release
api.github.com/repos/katspaugh/wavesurfer.js/releases - 2026-11-17: Contributors
api.github.com/repos/katspaugh/wavesurfer.js/contributors - 2026-11-17: Dependent packages, Dependent repositories
packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/wavesurfer.js - 2026-11-17: npm downloads a week
api.npmjs.org/downloads/range/2026-11-01:2026-11-07/wavesurfer.js