🎵 Audio Visualizer

A Flutter package for seamlessly visualizing audio from files, assets, HTTP streams, microphone input, and raw PCM16 data.

Explore all usage examples in the example directory.

Demo App 1 Demo App 2

✨ Features

Feature	Android	iOS
Visualize File	✅	✅
Visualize Asset	✅	✅
Visualize HTTP	✅	✅
Visualize Microphone	✅	✅
Visualize Raw PCM16	✅	✅

📦 Components Overview

This package provides three major components:

VisualizerPlayer
For visualizing audio from files, assets, and HTTP streams.
PCMVisualizer
For visualizing raw PCM16 data from custom sources.

🚀 Visualizer Styles and Bands

Pre-built Visualizer Styles

Elevate your app's aesthetic with four stunning, ready-to-use visualizer widgets:

BarVisualizer
CircleVisualizer
LineVisualizer
MultiWaveVisualizer
RainbowBlockVisualizer

Band Types

Choose from six band types to suit your visualization needs:

fourBand
fourBandVisual
eightBand
tenBand
twentySixBand
thirtyOneBand

🎧 How to Use

Visualizing an Audio File

Load audio using the appropriate prefix:

Assets: asset://path_to_asset
Files: file://path_to_file
HTTP: http://url or https://url

Example:

// Initialize VisualizerPlayer
final audioPlayer = VisualizerPlayer();
await audioPlayer.initialize();
await audioPlayer.setDataSource("asset://assets/sample.mp3");
await audioPlayer.play();

// Visualize with BarVisualizer
ListenableBuilder(
   listenable: audioPlayer,
   builder: (context, child) {
      return BarVisualizer(
         input: audioPlayer.value.waveform,
         backgroundColor: Colors.black,
         color: Colors.greenAccent,
         gap: 2,
      );
   },
),

// Dispose VisualizerPlayer
audioPlayer.dispose();

Visualizing Microphone Input

This package does not directly handle microphone input. You can use the record package to capture audio and feed it into the visualizer.

Example:

// Initialize PCMVisualizer
final pcmVisualizer = PCMVisualizer();
pcmVisualizer.feed(rawPCM16Data);

// Visualize with BarVisualizer
ListenableBuilder(
   listenable: pcmVisualizer,
   builder: (context, child) {
      return BarVisualizer(
         input: pcmVisualizer.value.waveform,
         backgroundColor: Colors.black,
         color: Colors.greenAccent,
         gap: 2,
      );
   },
),

// Dispose PCMVisualizer
pcmVisualizer.dispose();

⚙️ Permissions

On Android, the following permission is required to visualize audio:

<uses-permission android:name="android.permission.RECORD_AUDIO" />

🙏 Acknowledgements

This project is inspired by and leverages ideas and code from the following: