Pricing
Get Started
  • Introduction
  • Installation
  • MCP Server
  • Saved
Site
  • Builder (Beta)
  • Pricing
  • Roadmap
  • Affiliates
Browse
  • All Components25 New
Text32
Reveal & Decode11
  • Blur Highlight
  • Cipher Reveal
  • Ghost Type
  • Glyph Lottery
  • Luminous Type
  • Signal Type
  • Smoke Type
  • Staggered Text
  • Text Morph
  • Typographic Wall
  • Vapor Type
Kinetic & 3D11
  • 3D Letter Swap
  • 3D Text Reveal
  • Bending Marquee
  • Mesh Lettering
  • Orbital Type
  • Ribbon Type
  • Rising Ink
  • Speeding Text
  • Text Cube
  • Text Path
  • Wave Lettering
Interactive & Physics10
  • ASCII Ripple
  • Domino Lettering
  • Elastic Lettering
  • Glitch Text
  • Gravity Letters
  • Particle Text
  • Shatter Type
  • Spring Lettering
  • Stipple Type
  • Text Scatter
Backgrounds106
Gradients & Fluids21
  • Aura Blob
  • Aurora Blur
  • Chroma Waves
  • Cloud Atlas
  • Color Loops
  • Glowing Ridges
  • Gradient Bars
  • Gradient Blob
  • Grain Wave
  • Liquid Bars
  • Minimal Ripple
  • Radial Liquid
  • Rubber Fluid
  • Satin Ridges
  • Shader Waves
  • Silk Waves
  • Simple Swirl
  • Spectral Clouds
  • Stipple GradientNew
  • Swirl Blend
  • Watercolor
Light & Beams14
  • Aurora Beam
  • Axial Beam
  • Blurred Rays
  • Chroma Blinds
  • Dappled Light
  • Eclipse
  • Falling Rays
  • Flame Paths
  • Horizon Bloom
  • Light Droplets
  • Neon Reveal
  • Nexus Rays
  • Rolling Blinds
  • Shadow Bars
Lines & Filaments12
  • Concentric Tides
  • Glowing Wave
  • Interference Ribbons
  • Liquid Lines
  • Long Exposure
  • Luminous Filaments
  • Neural Flash
  • Neural Float
  • Rising Lines
  • Spiral Funnel
  • Synaptic Shift
  • Twilight Lines
Dots & Pixels22
  • Blinking Dots
  • Blinking Squares
  • Chroma Current
  • Circuit FlashNew
  • Cursor Wave
  • Dither Wave
  • Dot Shift
  • Dotted WavesNew
  • Glue Dots
  • Grid Rise
  • Halftone Vortex
  • Halftone Wave
  • Hexagonal Vault
  • Mosaic
  • Mosaic Waves
  • Pixel Rain
  • Square Matrix
  • Squares Terminal
  • Squircle Shift
  • Tech Wall
  • Thinking Dots
  • Voxel Arc
Particles & Space11
  • Astral Shell
  • Binary Orbits
  • Contour Tide
  • Fading Stars
  • Glimmer Wrap
  • Grain MassNew
  • Ring Field
  • Rising Particles
  • Rotating Stars
  • Spectral Drape
  • Star Burst
Horizons & Tunnels10
  • Glitter Warp
  • Landscape
  • Lightspeed
  • Neural Tunnel
  • Perspective Grid
  • Ravine
  • Retro Lines
  • Star Swipe
  • Vortex
  • Warp Twister
ASCII & Glyphs9
  • ASCII StreamNew
  • ASCII Tiles
  • Ascii Waves
  • Glyph Ember
  • Glyph Orb
  • Glyph Sonar
  • Glyph Tide
  • Liquid Ascii
  • Terminal Rain
Glass & Chrome7
  • Glass CoinsNew
  • Glass Flow
  • Glass KeysNew
  • Glass Tiles
  • Metallic Swirl
  • Prismatic Slats
  • Spectral TilesNew
Images & Galleries52
Galleries & Carousels33
  • Album Rail
  • Bend Gallery
  • Circle Gallery
  • Circle Stack
  • Circles
  • Concave Carousel
  • Constellation Gallery
  • Contact Sheet
  • Depth Ribbon
  • Dolly Gallery
  • Draggable Grid
  • Elastic Reel
  • Expanding Grid
  • Gradient Carousel
  • Helix Gallery
  • Infinite Gallery
  • Inverted Dome
  • Iris Gallery
  • Lenticular Carousel
  • Liquid CirclesNew
  • Momentum Ring
  • Orbit Reel
  • Parallax Carousel
  • Passage Gallery
  • Prism Carousel
  • Reel Gallery
  • Rotating Cards
  • Scroll Bend
  • Skewed Carousel
  • Spin Shutter
  • Tilted Tiles
  • Tumble Carousel
  • Twisting Gallery
Image Effects14
  • Comparison Slider
  • Depth Image
  • Ember Reveal
  • Glass Reveal
  • Hover Preview
  • Liquid Swap
  • Loupe Image
  • Particle Image
  • Particle Morph
  • Pixel Reveal
  • Pixel Sculpt
  • Pixelate Hover
  • Pond Image
  • Shader Reveal
Scroll Stories5
  • Frame Scrub
  • Scroll Mask
  • Scroll Portal
  • Scroll Stack
  • Tile Reveal
Interface30
Cards & Widgets15
  • Animated ListUpdated
  • Arc ListNew
  • Card Spread
  • Chroma Card
  • Click Stack
  • Credit Card
  • Depth Card
  • Frame Border
  • Modal Cards
  • Parallax Cards
  • Parallax Pills
  • Preloader
  • Shader Card
  • SignatureNew
  • Warped Card
Product Mockups8
  • Browser WindowNew
  • Center Flow
  • Code MorphNew
  • Device
  • Magic Transform
  • PipelineNew
  • Spin ViewerNew
  • Terminal ReplayNew
Data & Media7
  • Globe
  • Instrument DialNew
  • Particle ChartNew
  • Signal MapNew
  • Simple Graph
  • Story PlayerNew
  • Waveform PlayerNew
3D & Tactile16
Orbs & Shapes9
  • Agentic Ball
  • AI Blob
  • Black Hole
  • Chrome Orbit
  • Fog Sphere
  • Photon Knot
  • Portal
  • Specter Orb
  • Wireframe Ball
Tactile & Physics7
  • Elastic Sticker
  • KeycapsNew
  • Page Flip
  • Pin ScreenNew
  • Receipt PrinterNew
  • Scratch CardNew
  • Tumble Wall
Cursors19
Custom Cursors7
  • Custom Cursor
  • Drafting Cursor
  • Glass Cursor
  • Gyroscope Cursor
  • Label Orbit
  • Smooth Cursor
  • User Cursor
Cursor Trails12
  • Arc Cursor
  • Ascii Cursor
  • Celebration Cursor
  • Chroma Halo
  • Dither Cursor
  • Glyph Stream
  • Pigment Trail
  • Pixel Magnet
  • Ribbon Trail
  • Snapshot Trail
  • Stardust Cursor
  • Tessera Trail
  1. Docs
  2. Components
  3. Interface
  4. Data & Media
  5. Waveform Player

Animated components, blocks, and templates for React. Pay once, ship stunning pages forever.

pro@reactbits.dev

Site

HomeBuilder (Beta)PricingTestimonialsFAQsRoadmapChangelogFree Components

Docs

IntroductionInstallationMCP ServerComponentsBlocksTemplates

Resources

AboutUse casesComparisonsAlternativesFor AI agents

Legal & Account

LoginAffiliateLicensePrivacyContact

© 2026 pro.reactbits.dev. All rights reserved.

Waveform Player

An audio player you scrub along its own waveform

waveform-player-tw

Customize

Accent
Wave
Surface
Bar Width
3px
Bar Gap
2px
Height
52px

Props

24
NameTypeDefaultDescription
srcstring—Audio file to play. It is also decoded once to draw the waveform, so cross-origin files need CORS.
peaksnumber[]—Precomputed waveform levels. Skips decoding, which is best for long episodes.
titlestring—Track title shown in the card.
artiststring—Line under the title.
coverstring—Cover image shown beside the title.
chapters{ time, title }[]—Splits the waveform with small gaps and names the chapter in the hover tooltip.
variant"card" | "inline""card"A full card with cover and times, or a compact row like a voice message.
barWidthnumber3Width of each bar in pixels.
barGapnumber2Space between bars in pixels.
heightnumber52 card, 30 inlineHeight of the waveform.
ratesnumber[]—Playback speeds to cycle through with a small chip, like [1, 1.5, 2]. Hidden when empty.
loopbooleanfalseStarts again from the top when the track ends.
exclusivebooleantruePauses any other player on the page when this one starts.
livebooleantrueThe bars around the playhead lift with the loudness of the music.
introbooleantrueThe player fades in and the bars grow from left to right the first time it scrolls into view.
theme"auto" | "light" | "dark""auto"Auto matches the player to the background behind it.
accentColorstringtext colourColour of the played bars and the play button.
waveColorstringfaded text colourColour of the bars that have not played yet.
surfaceColorstringfaint tintColour of the player panel.
onPlay / onPause / onEnded() => void—Called as playback starts, pauses and finishes.
onTimeUpdate(time: number) => void—Called four times a second while playing, with the current time in seconds.
ref{ play, pause, toggle, seek }—Controls playback from your own code. seek takes seconds.
classNamestring—Classes for the root element.
styleCSSProperties—Inline styles for the root element.
srcstring

Audio file to play. It is also decoded once to draw the waveform, so cross-origin files need CORS.

Default—
peaksnumber[]

Precomputed waveform levels. Skips decoding, which is best for long episodes.

Default—
titlestring

Track title shown in the card.

Default—
artiststring

Line under the title.

Default—
coverstring

Cover image shown beside the title.

Default—
chapters{ time, title }[]

Splits the waveform with small gaps and names the chapter in the hover tooltip.

Default—
variant"card" | "inline"

A full card with cover and times, or a compact row like a voice message.

Default"card"
barWidthnumber

Width of each bar in pixels.

Default3
barGapnumber

Space between bars in pixels.

Default2
heightnumber

Height of the waveform.

Default52 card, 30 inline
ratesnumber[]

Playback speeds to cycle through with a small chip, like [1, 1.5, 2]. Hidden when empty.

Default—
loopboolean

Starts again from the top when the track ends.

Defaultfalse
exclusiveboolean

Pauses any other player on the page when this one starts.

Defaulttrue
liveboolean

The bars around the playhead lift with the loudness of the music.

Defaulttrue
introboolean

The player fades in and the bars grow from left to right the first time it scrolls into view.

Defaulttrue
theme"auto" | "light" | "dark"

Auto matches the player to the background behind it.

Default"auto"
accentColorstring

Colour of the played bars and the play button.

Defaulttext colour
waveColorstring

Colour of the bars that have not played yet.

Defaultfaded text colour
surfaceColorstring

Colour of the player panel.

Defaultfaint tint
onPlay / onPause / onEnded() => void

Called as playback starts, pauses and finishes.

Default—
onTimeUpdate(time: number) => void

Called four times a second while playing, with the current time in seconds.

Default—
ref{ play, pause, toggle, seek }

Controls playback from your own code. seek takes seconds.

Default—
classNamestring

Classes for the root element.

Default—
styleCSSProperties

Inline styles for the root element.

Default—