Skip to content
@WaveformPlayer

WaveformPlayer

Zero-config audio waveforms for the web. No build step, no dependencies.

WaveformPlayer — beautiful, zero-dependency audio visualization for the web


Zero-config audio waveforms for the web. Add a data- attribute to any <div> and get a real, interactive waveform player.

  • No build step, no dependencies. Vanilla JS, about 15 KB gzipped.
  • Six waveform styles, themeable with CSS.
  • Keyboard control and Media Session out of the box.
  • Extensions for a site-wide bar, playlists, sample-pack browsing and listen analytics.
  • Components for Astro, React, Svelte and Vue.

Quick start

<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="track.mp3" data-title="My Song" data-artist="The Artist"></div>

Or from npm:

npm install @arraypress/waveform-player
import WaveformPlayer from '@arraypress/waveform-player';

new WaveformPlayer('#player', { url: 'track.mp3', title: 'My Song', artist: 'The Artist' });

Packages

WaveformPlayer
CORE · npm

Canvas waveform player with six styles, keyboard control and Media Session.

WaveformBar
EXTENSION · npm

A persistent bottom bar: queue, volume, repeat, favourites, cart and cross-page sessions.

WaveformPlaylist
EXTENSION · npm

Playlists and chapters for podcasts, courses, albums and audiobooks.

WaveformSounds
EXTENSION · npm

A searchable, filterable sound list for sample packs, with a mini waveform per row.

WaveformTracker
EXTENSION · npm

Privacy-first listen analytics that count real listening time. No cookies.

WaveformGen
TOOLING · npm

A Node CLI and library that pre-generates waveform peaks and BPM from audio files.

Framework components

One package per framework, with a sub-path per component: /player, /bar, /playlist and /sounds. Install only the cores you use.


Astro

React

Svelte

Vue
astro
npm
react
npm
svelte
npm
vue
npm
import { WaveformPlayer } from '@arraypress/waveform-react/player';

Popular repositories Loading

  1. waveform-player waveform-player Public

    Lightweight, customizable audio player with waveform visualization

    TypeScript 52 7

  2. waveform-gen waveform-gen Public

    Generate waveform peak data from audio files — per-file JSON for WaveformPlayer and WaveformBar, or one sounds manifest (with BPM and key from file names) for WaveformSounds. CLI and Node.js library.

    TypeScript 2

  3. waveform-playlist waveform-playlist Public

    Playlist and chapter navigation for WaveformPlayer

    JavaScript 1

  4. waveform-bar waveform-bar Public

    Persistent bottom audio player bar for WaveformPlayer - queue management, page persistence, and seamless playback

    TypeScript 1

  5. waveform-bar-astro waveform-bar-astro Public archive

    Replaced by @arraypress/waveform-astro/bar (WaveformPlayer 2.0). Archived — 1.x only.

    TypeScript 1

  6. waveform-bar-react waveform-bar-react Public archive

    Replaced by @arraypress/waveform-react/bar (WaveformPlayer 2.0). Archived — 1.x only.

    TypeScript 1

Repositories

Showing 10 of 29 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…