WaveformPlayer

The vanilla-JS waveform audio player — plus a bar, playlist, analytics and a peaks CLI. A small, zero-dependency family configured from plain markup: drop in a script and a few data-* attributes and ship. ~10KB gzipped, no dependencies.

<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>

<div data-waveform-player data-url="/audio/track.mp3" data-waveform-style="mirror"></div>

That is a complete, working player. Start with Installation and Quick start.

Building with an AI agent?

Point it at waveformplayer.com/llms.txt — a machine-readable reference for the whole family.

The core player

OptionsEvery option, as a JS prop or data-* attribute.

Data attributesThe full markup contract.

Methods & eventsDrive and observe playback.

StylingColors, presets and CSS variables.

Extensions

WaveformBarPersistent Spotify-style bottom bar.

WaveformPlaylistPlaylists, chapters and albums.

WaveformTrackerPrivacy-first listen analytics.

WaveformGenPre-generate peaks at build time.

Every environment

Plain HTML / CDNNo build step.

ReactTyped component + ref handle.

AstroTyped, SSR-safe component.

VueMount in onMounted.

WordPressEnqueue + shortcode.

ShopifyTheme + Liquid sections.