wav2json 0.2.0

A library that decodes wav audio files into json waveform data
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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# wav2json

A library that decodes wav audio files into json waveform data

[![Crates.io](https://img.shields.io/crates/v/wav2json.svg)](https://crates.io/crates/wav2json)
[![Documentation](https://docs.rs/wav2json/badge.svg)][dox]
[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

More information about this crate can be found in the [crate documentation][dox].

[dox]: https://docs.rs/wav2json

## Usage

To use `wav2json`, first add this to your `Cargo.toml`:

```toml
[dependencies]
wav2json = "0.2.0"
```

Next, add this to your crate:

```rust
use wav2json::Wav;

fn main() {
    // ...
}
```

## Examples

Generate a json waveform data file:

```rust
use std::{error::Error, fs::File, time::Instant};
use wav2json::Wav;

fn main() -> Result<(), Box<dyn Error>> {
    let start = Instant::now();

    // Support for local and network files.
    // let mut wav = Wav::new("http://[host]/sample-15s.wav")?.set_json_width(1920);
    let mut wav = Wav::new("examples/sample-15s.wav")?.set_json_width(1920);
    let result_data = wav.decode()?;

    println!("duration: {}", start.elapsed().as_millis());

    // Generate json data files that can be rendered.
    let json_file = File::create("examples/data.json")?;
    serde_json::to_writer(json_file, &result_data)?;

    Ok(())
}
```

Copy the resulting json data into the index.html file, and then open the web page to see the effect as shown in the following image

![Waveform picture](https://github.com/caojianyu/wav2json/blob/main/examples/example.png)

## License

wav2json is provided under the MIT license. See [LICENSE](LICENSE).