#midi #gamedev #control #audio #bevy #sound-font

bevy_midix

The MIDI plugin for humans. Out-of-the-box soundfont synthesizer, commands, and input!

11 releases (stable)

Uses new Rust 2024

new 3.2.2 Apr 16, 2025
3.1.1 Apr 15, 2025
2.0.0 Dec 30, 2024
1.0.0 Dec 18, 2024
0.0.1 Dec 14, 2024

#869 in Game dev

Download history 97/week @ 2024-12-26 17/week @ 2025-01-02 1/week @ 2025-01-09 1/week @ 2025-01-30 3/week @ 2025-02-06 1/week @ 2025-02-13 7/week @ 2025-02-20 12/week @ 2025-02-27 1/week @ 2025-03-13 707/week @ 2025-04-10

714 downloads per month

MIT/Apache

2.5MB
9K SLoC

bevy_MIDIx

github crates.io

Bevy plugin that uses midix, midir, and a rustysynth fork to play midi sounds!

Read from MIDI devices, MIDI files, and programmable input, and output to user audio with a soundfont!

Features

  • Enable web for WASM compatibility

Example

use std::time::Duration;
use bevy::{
    log::{Level, LogPlugin},
    prelude::*,
};
use bevy_midix::{midix::prelude::*, prelude::*};
fn main() {
    App::new()
        .add_plugins((
            DefaultPlugins.set(LogPlugin {
                level: Level::INFO,
                ..default()
            }),
            MidiPlugin {
                input: None,
                ..Default::default()
            },
        ))
        .add_systems(Startup, load_sf2)
        .add_systems(Update, scale_me)
        .run();
}
/// Take a look here for some soundfonts:
///
/// <https://sites.google.com/site/soundfonts4u/>
fn load_sf2(asset_server: Res<AssetServer>, mut synth: ResMut<Synth>) {
    synth.use_soundfont(asset_server.load("soundfont.sf2"));
}

struct Scale {
    timer: Timer,
    current_key: Key,
    note_on: bool,
    forward: bool,
    incremented_by: u8,
    max_increment: u8,
}

impl Scale {
    pub fn calculate_next_key(&mut self) {
        if self.forward {
            if self.incremented_by == self.max_increment {
                self.forward = false;
                self.incremented_by -= 1;
                self.current_key -= 1;
            } else {
                self.incremented_by += 1;
                self.current_key += 1;
            }
        } else if self.incremented_by == 0 {
            self.forward = true;
            self.incremented_by += 1;
            self.current_key += 1;
        } else {
            self.incremented_by -= 1;
            self.current_key -= 1;
        }
    }
}

impl Default for Scale {
    fn default() -> Self {
        let timer = Timer::new(Duration::from_millis(200), TimerMode::Repeating);
        Scale {
            timer,
            current_key: Key::new(Note::C, Octave::new(2)),
            note_on: true,
            forward: true,
            incremented_by: 0,
            max_increment: 11,
        }
    }
}

fn scale_me(synth: Res<Synth>, time: Res<Time>, mut scale: Local<Scale>) {
    // don't do anything until the soundfont has been loaded
    if !synth.is_ready() {
        return;
    }
    scale.timer.tick(time.delta());
    if !scale.timer.just_finished() {
        return;
    }
    if scale.note_on {
        //play note on
        synth.handle_event(ChannelVoiceMessage::new(
            Channel::One,
            VoiceEvent::note_on(scale.current_key, Velocity::max()),
        ));
    } else {
        //turn off the note
        synth.handle_event(ChannelVoiceMessage::new(
            Channel::One,
            VoiceEvent::note_off(scale.current_key, Velocity::max()),
        ));
        scale.calculate_next_key()
    }

    scale.note_on = !scale.note_on;
}

See /examples for details.

Acknowledgment

This crate was originally forked from bevy_midi. Please check them out if this crate doesn't suit your needs!

Dependencies

~45–77MB
~1.5M SLoC