waveform_pro #

A production-quality, GPU-accelerated Flutter audio waveform visualization library supporting continuous envelopes, discrete SoundCloud-style bars, bezier curved splines, dual-color playback progress, interactive zooming/panning, draggable region selection, cue markers, live audio stream buffering, and headless PNG exports.

Now available on pub.flutter-io.cn/packages/waveform_pro.

✨ Features #

• 📊 Multiple Render Modes:
  • WaveformRenderMode.continuous — Classic mirrored continuous path.
  • WaveformRenderMode.bars — Discrete rounded vertical bars (SoundCloud & Apple Voice Memos style).
  • WaveformRenderMode.curvedSpline — Ultra-smooth cubic bezier spline curves.
• ⏯️ Dual-Color Playback Progress — Colorize played vs unplayed waveform segments (playedWaveColor vs waveColor) based on playheadPosition.
• ⚡ Multi-Resolution Pyramid Caching — Decimates waveform data at powers-of-two for 60fps rendering across any zoom level.
• 🔍 Interactive Timeline — Pinch-to-zoom, horizontal drag/pan, and programmatic WaveformController with automatic viewport adaptation.
• 📍 Regions & Cue Markers — Interactive region selection with draggable bounds and labeled cue bookmarks.
• 🎙️ Live Audio Buffer Support — Dynamically append audio peaks to WaveformData (data.append(...)) for real-time recorders.
• 🖼️ Headless PNG Image Exporter — Generate waveform images directly to Uint8List via WaveformExporter.toPngBytes(...) without mounting widgets.
• 🎨 Built-in Presets — Ready-to-use themes like WaveformStyle.voiceMemo and WaveformStyle.neonGlow.

📦 Installation #

Add waveform_pro to your Flutter project:

flutter pub add waveform_pro

Or add it to your pubspec.yaml dependencies:

dependencies:
  waveform_pro: ^1.1.0

Import:

import 'package:waveform_pro/waveform_pro.dart';

🚀 Usage #

1. Basic Waveform Timeline (SoundCloud / Voice Memos Bar Style) #

import 'package:flutter/material.dart';
import 'package:waveform_pro/waveform_pro.dart';

class AudioPlayerWaveform extends StatelessWidget {
  final WaveformData waveformData;

  const AudioPlayerWaveform({super.key, required this.waveformData});

  @override
  Widget build(BuildContext context) {
    return WaveformTimeline(
      data: waveformData,
      style: WaveformStyle.voiceMemo,
      playheadPosition: 12.4, // seconds played
      playheadColor: Colors.blueAccent,
      showTimeRuler: true,
      onTap: (seconds) {
        print('User seeked to: ${seconds}s');
      },
      onRegionChanged: (start, end) {
        print('Selected region: $start - $end');
      },
    );
  }
}

2. Smooth Curved Spline Mode #

WaveformTimeline(
  data: waveformData,
  style: WaveformStyle.neonGlow,
  playheadPosition: 5.0,
  height: 140,
)

3. Live Streaming / Real-time Audio Recording #

WaveformData liveData = WaveformData(samples: [], durationSeconds: 0);

// As microphone buffer packets arrive:
void onAudioBufferReceived(List<double> newPeaks, double bufferDuration) {
  setState(() {
    liveData = liveData.append(newPeaks, addedDurationSeconds: bufferDuration);
  });
}

4. Headless PNG Image Export (Thumbnails / Notifications) #

import 'dart:typed_data';
import 'package:waveform_pro/waveform_pro.dart';

Future<Uint8List> generateWaveformThumbnail(WaveformData data) async {
  return await WaveformExporter.toPngBytes(
    data: data,
    width: 600,
    height: 150,
    style: WaveformStyle.voiceMemo,
    playheadPosition: 20.0,
  );
}

🛠️ API Overview #

🧪 Testing #

flutter test

📄 License #

This package is licensed under the MIT License.