audio-visualizer 0.3.0

Smple audio visualization library which is especially useful for developers to visually check audio samples, e.g. by waveform or spectrum. (So far) this library is not capable of doing nice visualizations for end users.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# Rust library: audio-visualizer

So far this library is rather basic and targets developers that develop audio algorithms. With this library you can
easily display your current audio data/waveform/spectrum and check if everything looks good/as expected.

## Covered Functionality

- **dynamic real-time audio**
    - [x] functionality to record audio and connect it with a GUI window
    - [x] side-by-side (top/btm) view of original waveform and custom view (e.g. spectrum or lowpass filter)
    - [x] cross-platform (Windows with WASAPI, Linux with ALSA, MacOS with coreaudio)
- **static waveform**
    - [x] very basic PNG output
    - [x] PNG output with basic axes/labels using https://crates.io/crates/plotters
    - [ ] TODO fancy static output (code contributions are welcome)

- **static spectrum**
    - [x] very basic PNG output with the option to highlight specific frequencies
      (definitely needs more work, code contributions are welcome)
    - [x] PNG output with basic axes/labels using https://crates.io/crates/plotters
      (definitely needs more work, code contributions are welcome)
    - [ ] TODO fancy static output (code contributions are welcome)

## (Code) Examples
There are several examples in the `examples/` directory. Below, you can see some visualization examples.

### Real-time audio + lowpass filter (6.9MB GIF)
![Example visualization of real-time audio + lowpass filter](res/live_demo_lowpass_filter_green_day_holiday.gif "Example visualization of real-time audio + lowpass filter") \
On the top you see the original waveform of the song Holiday by Green Day. On the bottom you see the data after a
lowpass filter was applied. The beats are visible.

### Real-time audio + frequency spectrum (5.4MB GIF)
![Example visualization of real-time audio + lowpass filter](res/live_demo_spectrum_green_day_holiday.gif "Example visualization of real-time audio + lowpass filter") \
On the top you see the original waveform of the song Holiday by Green Day. On the bottom you see
the frequency spectrum of the latest 46ms of audio. Frequencies <2000Hz are clearly present.


### Example of a static waveform

![Example visualization of a waveform](png_waveform_example.png "Example visualization of a waveform")

### Example of a static spectrum

![Example visualization of a spectrum (0-140hz)](plotters_spectrum_example.png "Example visualization of a spectrum (0-140hz)")

## MSRV
The MSRV is 1.56.1 stable.