New — WaveformSounds: search, filter and audition a whole sample pack from one list. Try it →

Packages

The whole family on npm.

A small, zero-dependency set of vanilla-JS audio packages — scoped under @arraypress, all MIT-licensed. Versions are live from npm.

22 packages 533.1k downloads / month 52 GitHub stars

Core

The foundation everything else builds on.
WaveformPlayer ~15KB v1.30.1

The zero-config core. Canvas waveform player with six visual styles, keyboard control and Media Session — vanilla JS, zero dependencies.

npm i @arraypress/waveform-player
530k/mo npm GitHub

Extensions

Optional add-ons that drive the core player.
WaveformBar ~13KB v1.12.2

Persistent Spotify-style bottom bar — queue, volume, repeat, favorites, cart, DJ markers and cross-page session persistence.

npm i @arraypress/waveform-bar
940/mo npm GitHub
WaveformPlaylist ~7KB v1.9.0

Playlist and chapter navigation — podcasts, courses, albums and audiobooks. Fully keyboard-accessible.

npm i @arraypress/waveform-playlist
285/mo npm GitHub
WaveformSounds ~14KB v0.3.1

Searchable, filterable sound list for sample packs — a mini waveform per row, type / key / BPM filters, keyboard auditioning and one shared audio engine.

npm i @arraypress/waveform-sounds
225/mo npm GitHub
WaveformTracker ~2KB v1.1.0

Privacy-first listen analytics. Credits real media-time engagement, ignores seeks, no cookies — send to any endpoint.

npm i @arraypress/waveform-tracker

Tooling

Build-time helpers — no runtime.
WaveformGen v2.2.0

Node CLI + library to pre-generate waveform peaks (and BPM) from audio files — instant render, no client-side decode.

npm i @arraypress/waveform-gen
114/mo npm GitHub

Framework wrappers

Typed Astro, React, Vue & Svelte components.
Player · Astro v0.8.0

Typed Astro component wrapper with lazy IntersectionObserver mounting.

npm i @arraypress/waveform-player-astro
316/mo npm GitHub
Player · React v0.9.0

React wrapper — forwardRef imperative handle and typed props.

npm i @arraypress/waveform-player-react
359/mo npm GitHub
Bar · Astro v0.5.1

<WaveformBar> + <WaveformBarTrigger> components for Astro.

npm i @arraypress/waveform-bar-astro
Bar · React v0.5.0

<WaveformBar> + <WaveformBarTrigger> components for React.

npm i @arraypress/waveform-bar-react
Playlist · Astro v0.5.0

Typed <WaveformPlaylist> for Astro — tracks and chapters as props.

npm i @arraypress/waveform-playlist-astro
Playlist · React v0.5.0

React <WaveformPlaylist> — typed tracks/chapters and a ref handle.

npm i @arraypress/waveform-playlist-react
Player · Vue v0.7.0

Vue 3 wrapper — typed props, event emits and a template-ref imperative handle.

npm i @arraypress/waveform-player-vue
Player · Svelte v0.7.0

Svelte 5 wrapper — typed props, callback props and exported instance methods.

npm i @arraypress/waveform-player-svelte
Bar · Vue v0.4.0

<WaveformBar> + <WaveformBarTrigger> components for Vue 3.

npm i @arraypress/waveform-bar-vue
Bar · Svelte v0.4.0

<WaveformBar> + <WaveformBarTrigger> components for Svelte 5.

npm i @arraypress/waveform-bar-svelte
Playlist · Vue v0.5.0

Vue 3 <WaveformPlaylist> — declarative tracks/chapters and a ref handle.

npm i @arraypress/waveform-playlist-vue
Playlist · Svelte v0.5.0

Svelte 5 <WaveformPlaylist> — declarative tracks/chapters and exported nav methods.

npm i @arraypress/waveform-playlist-svelte
Sounds · Astro v0.2.1

Server-rendered <WaveformSounds> for Astro — the runtime adopts the markup, ClientRouter-safe.

npm i @arraypress/waveform-sounds-astro
Sounds · React v0.2.1

React <WaveformSounds> — typed props, callback props and an imperative ref handle.

npm i @arraypress/waveform-sounds-react
Sounds · Vue v0.2.1

Vue 3 <WaveformSounds> — typed props, lifecycle emits and an exposed API.

npm i @arraypress/waveform-sounds-vue
Sounds · Svelte v0.2.1

Svelte 5 <WaveformSounds> — typed props, callback props and exported instance methods.

npm i @arraypress/waveform-sounds-svelte

New here? Start with the docs or browse the products.

Start shipping beautiful audio.

Free, open-source and ~12KB — add a div and go.

Read the docs

API reference, guides and recipes for all nine packages.

Browse docs

Open the builder

Configure a player visually and copy the HTML, JS or React.

Try it

Star on GitHub

MIT-licensed, open source, zero dependencies.

View source