flutter_audio_waveforms - GitLite

KO | EN

gitlite — search

#python #llm #android #machine-learning #rust #docker #macos #nodejs #java #windows #cli #pytorch #mcp #openai

flutter_audio_waveforms

(★ 128)

A UI library for easily adding audio waveforms to your apps, with several customization options.

파일 탐색기

최종 버전 다운로드 (.zip)

- dependabot.yml
- FUNDING.yml
- - .gitignore
  - build.gradle
  - gradle.properties
  - settings.gradle
- - audio.mp3
  - audio_data.json
  - dance_monkey.mp3
  - dm.json
  - shape_of_you.mp3
  - soy.json
  - sp.json
  - surface_pressure.mp3
- - .gitignore
  - Podfile
- - load_audio_data.dart
  - main.dart
  - waveforms_dashboard.dart
- - .gitignore
  - Podfile
  - Podfile.lock
- - widget_test.dart
- - favicon.png
  - index.html
  - manifest.json
- .gitignore
- .metadata
- analysis_options.yaml
- pubspec.lock
- pubspec.yaml
- README.md
- flutter_audio_waveforms.dart
- flutter_audio_waveforms_test.dart
.gitignore
.metadata
analysis_options.yaml
CHANGELOG.md
LICENSE
pubspec.lock
pubspec.yaml
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/logo/logo.png?raw=true">

<p align="center">
	<a href="https://github.com/rutvik110/flutter_audio_waveforms"  target="_blank"><img src="https://img.shields.io/pub/v/flutter_audio_waveforms.svg" alt="Pub.dev Badge"></a>
	<a href="https://opensource.org/licenses/MIT" rel="noopener" target="_blank"><img src="https://img.shields.io/badge/license-MIT-purple.svg" alt="MIT License Badge"></a>
</p>

A UI library for easily adding audio waveforms to your apps, with several customization options.

Web Demo - [Flutter Audio Waveforms Web Demo](https://rutvik110.github.io/Flutter-Audio-Waveforms-Demo/#/)

# Features

You can use the following available waveform types.

* Polygon
* Rectangle
* Squiggly
* Curved Polygon

<p>
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/inactive/polygon.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/inactive/rectangle.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/inactive/squiggly.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/inactive/curved_polygon.png?raw=true" height="150" width="300">

</p>

<br>

Need to add some gradient to your waveform? Say no more! You get it along with other customization options.
<p>
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/pg.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/rg.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/pa.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/ra.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/sa.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/pai.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/rai.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/sai.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/pf.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/paf2.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/pgf.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/paf.png?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/customizations/cpaf.png?raw=true" height="150" width="300">
</p>
<br>

Want an active track for your audio out of the box?
You get that too!
<p>
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/gifs/pa_gif.gif?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/gifs/ra_gif.gif?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/gifs/sa_gif.gif?raw=true" height="150" width="300">
<img src="https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/assets/images/gifs/cpa_gif.gif?raw=true" height="150" width="300">

</p>

<br>

> Check out the short demo of what package offers [here](https://vimeo.com/660623448)

# Getting started

The package gives you the ability to add waveforms and customize them.
It's mostly like a UI library for waveforms with an additional ability to show active track for playing audio.

So it relies on you to provide the necessary audio data which it needs to draw the waveform.
The data we need is basically a list of points/samples that represents that audio.

You can use this [audiowaveform program](https://github.com/bbc/audiowaveform) to get the [audio json file](https://gist.github.com/rutvik110/946ee0f3036a18da1297e57c547ae241) which will provide us the samples.
After installing this program on your machine, generate the json file for an audio by using this command in your terminal.
```dart
audiowaveform -i test.mp3 -o test.json
```

The generated data needs to be processed following some rules which are necessary to get the waveforms drawn properly. To process the data use [this processor](https://gist.github.com/rutvik110/31a588244d288e89368e8704c1437d34).

Once you have the processed data points list then you can just pass it down to any of the waveforms available and get started using them.

> Check out [this article](https://medium.com/@TakRutvik/how-to-add-audiowaveforms-to-your-flutter-apps-c948c205d2c7) for detailed introduction on this section.

# Usage

Usage of all waveforms available is the same with only exception of having more/less customization options for different waveforms.

```dart
 // For a regular waveform
 PolygonWaveform( 
   samples: [],
   height: height,
   width: width, 
 )

// If you want active track for playing audio, pass [maxDuration] and [elapsedDuration]
 PolygonWaveform( 
   samples: [],
   height: height,
   width: width,
   maxDuration: maxDuration,
   elapsedDuration: elapsedDuration, 
 )
 ```

> Find detailed [example here](https://github.com/rutvik110/flutter_audio_waveforms/blob/master/example/lib/main.dart).

# Properties

**maxDuration**:

Maximum duration of the audio.

**elapsedDuration**:

Elapsed Duration of the audio.

**samples**:

List of the audio data samples.
> Check the **Getting Started** section on how to generate this.

**height** :

Waveform height.

**width** :

Waveform width.

## Customization Options

**inactiveColor** :

Color of the inactive waveform.

**activeColor** :

Color of the active waveform.

**inactiveGradient** :

Gradient of the inactive waveform.

**activeGradient** :

Gradient of the active waveform.

**absolute** :

Waveform drawn is one sided either above x-axis or below it depending on what `invert` is set to.

Defaults to `false`.

**invert** :

Flips/inverts the waveform upside down.

Defaults to `false`.

**borderWidth** :

Width of the border around waveform.

Available only for `RectangleWaveform`.

**isRoundedRectangle** :

If true then rounded rectangles are drawn instead of regular rectangles.

Available only for `RectangleWaveform`.

**isCentered** :

If true then rectangles are centered along the Y-axis with respect to their center along their height.<br>
If [absolute] is true then this would've no effect.

Available only for `RectangleWaveform`.

**strokeWidth** :

Waveform stroke width.

Available only for `SquigglyWaveform`, `CurvedPolygonWaveform`.

**inactiveBorderColor**:

Border color for inactive waveform.

Available only for `RectangleWaveform`.

**activeBorderColor**:

Border color for active waveform.

Available only for `RectangleWaveform`.

**showActiveWaveform**:

Whether to show active waveform or not.

Defaults to `true`.

### **More customization options coming soon!**

# Contributing Guide

* Feature request :<br> If you have any new feature in mind from which this package can benefit then please let me know by filing an [issue here](https://github.com/rutvik110/flutter_audio_waveforms/issues).

* Improvements :<br> Got any suggestions on improving the package, anything from API to performance then let me know by filing the [issue here](https://github.com/rutvik110/flutter_audio_waveforms/issues).

* Bugs: <br> If you happen to come across anything that shoudln't be happening then please file an [issue here](https://github.com/rutvik110/flutter_audio_waveforms/issues) describing what the bug is and how to reproduce it with attached code and preview if possible.

# Additional information

What started as a challenge out of curiosity, is now a package that I hope will be helpful to many of you and it was actually really fun building it.

Learned some good stuff while working on it and I hope to make it much more going forward.

If this package helped you then I would appreciate if you ⭐️ the repo which would be enough for me to keep continue working on it 🤓 and feel free to drop by and [say hi](https://twitter.com/TakRutvik) anytime.