11 unstable releases (4 breaking)

0.5.1 Jan 2, 2021
0.5.0 Aug 27, 2020
0.4.0 Aug 26, 2020
0.3.5 Feb 20, 2020
0.1.0 Jan 31, 2018

#76 in Audio

Download history 3369/week @ 2023-12-13 2799/week @ 2023-12-20 2461/week @ 2023-12-27 2399/week @ 2024-01-03 3168/week @ 2024-01-10 3410/week @ 2024-01-17 2720/week @ 2024-01-24 2562/week @ 2024-01-31 3288/week @ 2024-02-07 3432/week @ 2024-02-14 3044/week @ 2024-02-21 3464/week @ 2024-02-28 3506/week @ 2024-03-06 2471/week @ 2024-03-13 3310/week @ 2024-03-20 2582/week @ 2024-03-27

12,425 downloads per month
Used in 32 crates (21 directly)

MIT license

69KB
1K SLoC

C 826 SLoC // 0.0% comments Shell 173 SLoC // 0.0% comments Rust 151 SLoC // 0.1% comments

minimp3 Rust bindings

Cargo package Cargo package Build Status

Usage example

# Cargo.toml

[dependencies]
minimp3 = "0.5"
use minimp3::{Decoder, Frame, Error};

use std::fs::File;

fn main() {
    let mut decoder = Decoder::new(File::open("audio_file.mp3").unwrap());

    loop {
        match decoder.next_frame() {
            Ok(Frame { data, sample_rate, channels, .. }) => {
                println!("Decoded {} samples", data.len() / channels)
            },
            Err(Error::Eof) => break,
            Err(e) => panic!("{:?}", e),
        }
    }
}

Async I/O

The decoder can be used with Tokio via the async_tokio feature flag.

# Cargo.toml

[dependencies]
minimp3 = { version = "0.4", features = ["async_tokio"] }

# tokio runtime
tokio = {version = "0.2", features = ["full"] }
use minimp3::{Decoder, Frame, Error};

use tokio::fs::File;

#[tokio::main]
async fn main() {
    let file = File::open("minimp3-sys/minimp3/vectors/M2L3_bitrate_24_all.bit").await.unwrap();
    let mut decoder = Decoder::new(file);

    loop {
        match decoder.next_frame_future().await {
            Ok(Frame {
                   data,
                   sample_rate,
                   channels,
                   ..
               }) => println!("Decoded {} samples", data.len() / channels),
            Err(Error::Eof) => break,
            Err(e) => panic!("{:?}", e),
        }
    }
}

Dependencies

~0.6–2.6MB
~48K SLoC