Skip to content

Waveform

Interactive waveform visualization with seek and chapter markers.

audio

Preview

Props & interactive options

Prop Type Default Description Try it
show_waveform url param 1 Display waveform visualization.
Browsers block autoplay with sound. Enabling auto_play automatically enables muted so playback can start; viewers can then unmute manually.

Documentation

Render the audio waveform from peaks data. Click anywhere on the waveform to seek. Chapter markers and buffered regions are shown directly on the waveform. Falls back to a standard progress bar when waveform data is unavailable.

Code

HTML

Frequently asked questions

Videas computes a peaks file during ingestion by sampling the audio amplitude at regular intervals. The resulting JSON is lightweight (a few KB) and delivered alongside the track, so the waveform renders instantly without re-decoding the full audio client-side.

The player falls back to a standard linear progress bar. As soon as the peaks file is generated (or if you disable the waveform via show_waveform=0), you get a classic and accessible experience — nothing blocks playback.

Yes — when chapters are defined, vertical markers are drawn on the waveform at each chapter start, giving listeners a visual map of the track they can click to seek.