Installation

WaveformPlayer is plain, dependency-free JavaScript. Add the stylesheet and the script, and it upgrades any [data-waveform-player] element on the page — no build step required.

CDN (no build step)

<link rel="stylesheet" href="https://unpkg.com/@arraypress/waveform-player/dist/waveform-player.css">
<script src="https://unpkg.com/@arraypress/waveform-player/dist/waveform-player.min.js"></script>

That’s everything. The script auto-initialises on load — see Quick start.

npm

npm

  npm i @arraypress/waveform-player

pnpm

  pnpm add @arraypress/waveform-player

yarn

  yarn add @arraypress/waveform-player

bun

  bun add @arraypress/waveform-player

Then import the core and the stylesheet:

import { WaveformPlayer } from '@arraypress/waveform-player';
import '@arraypress/waveform-player/dist/waveform-player.css';

Framework wrappers

Using Astro or React? Install the typed wrapper instead — see Astro and React.

For AI agents

The family ships a machine-readable reference at waveformplayer.com/llms.txt — point your coding agent at it and it can wire up a player correctly.