22 stable releases (4 major)

Uses old Rust 2015

4.0.10 Dec 20, 2023
4.0.8 Aug 30, 2023
4.0.6 May 14, 2021
4.0.4 Feb 18, 2021
0.2.0 Jan 22, 2018

#116 in Audio

Download history 392/week @ 2024-07-29 264/week @ 2024-08-05 145/week @ 2024-08-12 149/week @ 2024-08-19 159/week @ 2024-08-26 261/week @ 2024-09-02 99/week @ 2024-09-09 133/week @ 2024-09-16 187/week @ 2024-09-23 336/week @ 2024-09-30 204/week @ 2024-10-07 167/week @ 2024-10-14 143/week @ 2024-10-21 121/week @ 2024-10-28 92/week @ 2024-11-04 32/week @ 2024-11-11

477 downloads per month
Used in 4 crates (2 directly)

MIT license

80KB
1.5K SLoC

WMIDI

Midi encoding and decoding library.

crates.io docs.rs

License: MIT Build Status

Usage

use std::convert::TryFrom;

// Decoding messages from bytes.
fn handle_midi_message(bytes: &[u8]) -> Result<(), wmidi::FromBytesError> {
    let message = wmidi::MidiMessage::try_from(bytes)?;
    if let wmidi::MidiMessage::NoteOn(_, note, val) = message {
        let volume = u8::from(val) as u8 / 127.0;
        println!("Singing {} at volume {}", note, volume);
    }
    Ok(())
}

// Encoding messages to bytes.
fn midi_to_bytes(message: wmidi::MidiMessage<'_>) -> Vec<u8> {
    let mut bytes = vec![0u8; message.bytes_size()];
    message.copy_to_slice(bytes.as_mut_slice()).unwrap();
    bytes
}

Features

  • Supports no_std environments.
  • No memory allocations (therefore realtime safe) for parsing and encoding.
  • No memory allocations for creating MidiMessage, except for MidiMessage::OwnedSysEx.

Testing & Benchmarking

  • Build with cargo build.
  • Test with cargo test.
  • Benchmark with cargo bench. The results will be under ./target/criterion/report/index.html.

Changelog

4.0.0

  • New ControlFunction type which simply wraps a U7.
  • Constants and documentation for all ControlFunction values.
  • Renumber Note enums/consts to be more consistent with midi; for example, C0 is now C1.

3.1.0

  • Rename MidiMessage::wire_size() to MidiMessage::bytes_size().
  • Introduce MidiMessage::copy_to_slice() method.

3.0.0

  • Instances of U7 and U14 now have bounds checking.
  • Note is now an enum instead of a u8. Can be converted with Note::try_from and u8::from.

No runtime deps