# wavesurfer.js

Open-source JavaScript library that renders interactive, customizable audio waveforms and plays audio in the browser.


Source: https://findsoftware.frbit.cloud/wavesurfer/
Last reviewed: 2026-11-17
Listed since: 2026-11-17

## Record

### Links

- home: https://wavesurfer.xyz
- repository: https://github.com/katspaugh/wavesurfer.js
- docs: https://wavesurfer.xyz/docs/
- forum: https://github.com/wavesurfer-js/wavesurfer.js/discussions/categories/q-a

### Identity

- status: active
- maintainer: katspaugh
- maintainerType: individual
- parent: unknown
- firstRelease: 2013
- hqCountry: unknown

### Kind

- category: media, graphics
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: browser
- renderingModes: not applicable
- installMethod: npm, script tag

### License

- licenseModel: open-source
- license: BSD-3-Clause, CC-BY-3.0

### Releases

- currentMajor: 8
- latestReleaseDate: 2026-11-12

### Adoption

- githubStargazers: 10477
- packagistDownloads: not applicable
- npmWeeklyDownloads: 1989497
- contributors: 288
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 1317
- dependentPackages: 177

### Sources

- urls: https://wavesurfer.xyz/ (read 2026-11-17)
- urls: https://api.github.com/repos/katspaugh/wavesurfer.js (read 2026-11-17)
- urls: https://github.com/katspaugh/wavesurfer.js/blob/main/README.md (read 2026-11-17)
- category: https://github.com/katspaugh/wavesurfer.js/blob/main/README.md (read 2026-11-17)
- language: https://api.github.com/repos/katspaugh/wavesurfer.js (read 2026-11-17)
- runsAs: https://github.com/katspaugh/wavesurfer.js/blob/main/README.md (read 2026-11-17)
- installMethod: https://github.com/katspaugh/wavesurfer.js/blob/main/README.md (read 2026-11-17)
- installMethod: https://github.com/katspaugh/wavesurfer.js/blob/main/README.md (read 2026-11-17)
- license: https://api.github.com/repos/katspaugh/wavesurfer.js (read 2026-11-17)
- license: https://wavesurfer.xyz/about/ (read 2026-11-17)
- maintainer: https://github.com/katspaugh/wavesurfer.js/blob/main/LICENSE (read 2026-11-17)
- firstRelease: https://api.github.com/repos/katspaugh/wavesurfer.js/git/ref/tags/0.0.1 (read 2026-11-17)
- currentMajor: https://api.github.com/repos/katspaugh/wavesurfer.js/releases (read 2026-11-17)
- latestReleaseDate: https://api.github.com/repos/katspaugh/wavesurfer.js/releases (read 2026-11-17)
- githubStargazers: https://api.github.com/repos/katspaugh/wavesurfer.js (read 2026-11-17)
- contributors: https://api.github.com/repos/katspaugh/wavesurfer.js/contributors (read 2026-11-17)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/wavesurfer.js (read 2026-11-17)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/wavesurfer.js (read 2026-11-17)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/wavesurfer.js (read 2026-11-17)

## Notes

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](https://wavesurfer.xyz/docs/) 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.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
