FindSoftware

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

Current major version
87
Last release
2026-11-127

Adoption

GitHub stars
10,4772
npm downloads a week
1,989,49710
Contributors
2888
Dependent repositories
1,3179
Dependent packages
1779

Why these figures do not compare

Sources

  1. 2026-11-17: links
    wavesurfer.xyz/
  2. 2026-11-17: links, Written in, License, GitHub stars
    api.github.com/repos/katspaugh/wavesurfer.js
  3. 2026-11-17: links, Categories, Runs as, Install with
    github.com/katspaugh/wavesurfer.js/blob/main/README.md
  4. 2026-11-17: License
    wavesurfer.xyz/about/
  5. 2026-11-17: Maintainer
    github.com/katspaugh/wavesurfer.js/blob/main/LICENSE
  6. 2026-11-17: First release
    api.github.com/repos/katspaugh/wavesurfer.js/git/ref/tags/0.0.1
  7. 2026-11-17: Current major version, Last release
    api.github.com/repos/katspaugh/wavesurfer.js/releases
  8. 2026-11-17: Contributors
    api.github.com/repos/katspaugh/wavesurfer.js/contributors
  9. 2026-11-17: Dependent packages, Dependent repositories
    packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/wavesurfer.js
  10. 2026-11-17: npm downloads a week
    api.npmjs.org/downloads/range/2026-11-01:2026-11-07/wavesurfer.js

Last reviewed · Listed since Edit on GitHubThis page as markdownas JSON