Skip to content

Boddlnagg/midir

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

midir crates.io

Cross-platform, realtime MIDI processing in Rust.

Features

midir is inspired by RtMidi and supports the same features*, including virtual ports (except on Windows) and full SysEx support – but with a rust-y API!

* With the exception of message queues, but these can be implemented on top of callbacks using e.g. Rust's channels.

midir currently supports the following platforms/backends:

  • ALSA (Linux)
  • WinMM (Windows)
  • CoreMIDI (macOS, iOS)
  • WinRT (Windows 8+), enable the winrt feature
  • Jack (Linux, macOS), enable the jack feature
  • Web MIDI (Chrome, Opera, perhaps others browsers)
  • Android (API 29+, NDK AMidi + JNI)

A higher-level API for parsing and assembling MIDI messages might be added in the future.

Documentation & Example

API docs can be found at docs.rs. You can find some examples in the examples directory. Or simply run cargo run --example test_play after cloning this repository.

Android

  • Requires Android API 29+ and the Android NDK (r20b+).
  • Build (example, to remove before merging):
    • Install: cargo install cargo-ndk
    • Targets: rustup target add aarch64-linux-android
    • Build: cargo ndk -t arm64-v8a -o ./app/src/main/jniLibs build --release
  • Permissions/features:
    • Manifest should declare <uses-feature android:name="android.software.midi" android:required="false" /> (not needed for USB/BLE MIDI).

About

Cross-platform realtime MIDI processing in Rust.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 31

Languages