staskobzar

vue-audio-visual: Add Audio Visualizations to Vue Apps

vue-audio-visual is a Vue 3 library for drawing audio visualizations with the Web Audio API and canvas. It provides ready-made components for audio playback, live media streams, and interactive waveforms, with configurable visual styles.

View on GitHub Compare
Stars
800
Forks
112
Stars, last 30 days
+1

Our take

Health score

41/100

How it is scored
Activity
48
Community
48
Issues
21
Pull requests
45

+1 stars in the last 30 days

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

802

Forks

111

Change since Nov 14, 2026: 0 stars·0 forks

Overview

vue-audio-visual provides Vue components and composable functions for visualizing audio in web applications. It uses the Web Audio API and canvas to turn audio playback or a live MediaStream into visual displays, so developers can add audio feedback without building each renderer from scratch.

It is suited to Vue applications that need waveform, spectrum, bar, or circular displays alongside audio controls. The current plugin version supports Vue 3; Vue 2 projects need the older 2.5.1 release.

Key Features

  • Includes line, bar, circle, waveform, and media-stream visualization options.
  • Supports audio files through an audio element source and live input through a MediaStream.
  • Offers Vue components for direct template use and composables for working with audio and canvas refs.
  • Provides configurable canvas dimensions, colors, line and bar styling, and FFT size.
  • Makes the waveform clickable for changing playback position and can display playback time.
  • Allows media visualizations to be selected by type, including waveform, circle, frequency, and vertical bars.

Use Cases

  • Vue developers building a music or podcast player who want a waveform or spectrum display alongside playback controls.
  • Teams creating audio-focused interfaces that need configurable visual styles without implementing canvas drawing themselves.
  • Applications that visualize microphone or other live media input through a MediaStream.
  • Developers prototyping sound-reactive UI who want to use Vue components or composables with the Web Audio API.

Getting Started

Install the package with npm:

npm install --save vue-audio-visual

See the README for Vue setup, component options, and usage details.

Considerations

  • The current plugin version is compatible only with Vue 3. Vue 2 users need version 2.5.1.
  • Audio visualization depends on browser support for the HTML5 audio and Web Audio APIs.
  • Waveform rendering preloads audio content, so its use depends on the audio URL being fetchable by the browser.
  • The repository README links to a demo and documents component-specific props; check it for setup and configuration details before choosing a visualization.

Found this useful?

Share it with someone who would like vue-audio-visual.