zeba_academy_waveforms

A beautiful Flutter package for creating audio-inspired waveform visualizations, live animated waveforms, circular audio spectrums, and music equalizer effects.

Perfect for music players, podcasts, audio recording apps, media dashboards, visualizers, and modern UI experiences.

Features

✨ Audio waveform visualizers ✨ Live animated waveform effects ✨ Circular waveform visualizers ✨ Music equalizer animations ✨ Lightweight and highly customizable ✨ Pure Flutter implementation ✨ No external APIs required ✨ Easy integration

---

Installation

Add the dependency to your pubspec.yaml:

dependencies:
  zeba_academy_waveforms: ^1.0.0

Then run:

flutter pub get

---

Import

import 'package:zeba_academy_waveforms/zeba_academy_waveforms.dart';

---

Static Waveform

Display custom waveform data using sample values.

ZebaWaveform(
  samples: const [
    0.2,
    0.5,
    0.8,
    0.4,
    0.7,
    0.3,
  ],
  color: Colors.blue,
)

---

Animated Waveform

Create a continuously animated waveform effect.

const AnimatedWaveform(
  color: Colors.green,
)

---

Circular Waveform

Create a circular audio spectrum style visualizer.

const CircularWaveform(
  color: Colors.purple,
)

---

Music Equalizer

Display animated equalizer bars.

const ZebaEqualizer(
  color: Colors.red,
)

---

Complete Example

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Waveforms Demo'),
        ),
        body: SingleChildScrollView(
          padding: const EdgeInsets.all(20),
          child: Column(
            children: [
              ZebaWaveform(
                samples: const [
                  0.2,
                  0.4,
                  0.6,
                  0.8,
                  0.3,
                  0.5,
                ],
              ),

              SizedBox(height: 30),

              AnimatedWaveform(),

              SizedBox(height: 30),

              CircularWaveform(),

              SizedBox(height: 30),

              ZebaEqualizer(),
            ],
          ),
        ),
      ),
    );
  }
}

---

Included Widgets

Widget	Description
ZebaWaveform	Static audio waveform visualization
AnimatedWaveform	Live animated waveform
CircularWaveform	Circular spectrum visualizer
ZebaEqualizer	Animated music equalizer

---

Use Cases

• Music Player Apps
• Podcast Applications
• Voice Recorder Apps
• Audio Streaming Platforms
• Radio Apps
• DJ Dashboards
• Media Controls
• Audio Analytics
• Interactive UI Experiences

---

Performance

The package is built entirely with Flutter CustomPainter for efficient rendering and smooth animations while maintaining excellent performance across Android, iOS, Web, Windows, macOS, and Linux.

---

Roadmap

• Gradient Waveforms
• Neon Audio Visualizers
• Audio File Waveform Support
• Real-Time Microphone Visualization
• Spectrum Analyzer
• Waveform Seekbar
• Interactive Wave Editing
• Beat Detection Effects
• Audio Player Integration

---

Contributing

Contributions, issues, and feature requests are welcome.

Feel free to fork the repository and submit pull requests.

---

License

This project is licensed under the MIT License.

---

About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects.

You can learn more about me and my work at https://sufyanism.com or connect with me on LinkedIn:

https://www.linkedin.com/in/sufyanism

---

Your all-in-one learning hub!

🚀 Explore courses and resources in coding, tech, and development at zeba.academy and code.zeba.academy.

Empower yourself with practical skills through curated tutorials, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy

➡ Explore hands-on courses and resources at: https://code.zeba.academy

➡ Check out our YouTube for more tutorials: https://www.youtube.com/@zeba.academy

➡ Follow us on Instagram: https://www.instagram.com/zeba.academy/

Thank you for visiting!