Arduino MIDI Library

This library adds MIDI I/O communications to an Arduino board.

Features

• New : USB MIDI Device support with MIDIUSB.
• Compatible with all Arduino boards (and clones with an AVR processor).
• Simple and fast way to send and receive every kind of MIDI message (including all System messages, SysEx, Clock, etc..).
• OMNI input reading (read all channels).
• Software Thru, with message filtering.
• Callbacks to handle input messages more easily.
• Last received message is saved until a new one arrives.
• Configurable: overridable template-based settings.
• Create more than one MIDI interface for mergers/splitters applications.
• Use any serial port, hardware or software.

Getting Started

1. Use the Arduino Library Manager to install the library.

2. Start coding:

#include <MIDI.h>

// Create and bind the MIDI interface to the default hardware Serial port
MIDI_CREATE_DEFAULT_INSTANCE();

void setup()
{
    MIDI.begin(MIDI_CHANNEL_OMNI);  // Listen to all incoming messages
}

void loop()
{
    // Send note 42 with velocity 127 on channel 1
    MIDI.sendNoteOn(42, 127, 1);

    // Read incoming messages
    MIDI.read();
}

3. Read the documentation or watch the awesome video tutorials from Notes & Volts.

USB Migration

All USB related code has been moved into a separate repository Arduino-USB-MIDI, USB MIDI Device support with MIDIUSB, still using this library to do all the MIDI heavy-lifting.

Migration has been made as easy as possible: only the declaration of the MIDI object has been modified, the code remains identical.

4.3.1 code:

    #include <MIDI.h>
    #include <midi_UsbTransport.h>
    
    static const unsigned sUsbTransportBufferSize = 16;
    typedef midi::UsbTransport<sUsbTransportBufferSize> UsbTransport;
    
    UsbTransport sUsbTransport;
    
    MIDI_CREATE_INSTANCE(UsbTransport, sUsbTransport, MIDI);
    ...

become in 5.0.0

    #include  <USB-MIDI.h>
    USBMIDI_CREATE_DEFAULT_INSTANCE();
    ...

Start with the NoteOnOffEverySec example that is based on the original MidiUSB sketch. Note the only difference is in the declaration.

The USB-MIDI Arduino library depends on this library and the MIDIUSB library.

USB-MIDI uses the latest Arduino IDE depends feature in the library.properties file installing all the dependencies automatically when installing from the IDE.

Other Transportation mechanisms

Version 5 of this library, allows for other Transportation layers than the original MIDI 1.0 Electrical Specification.

• USB-MIDI
• AppleMIDI or rtpMIDI
• ipMIDI
• BLE-MIDI

All these Transportation layers use this library for all the underlying MIDI work, making it easy to switch transport protocols or making transport protocol bridges.

Documentation

• Doxygen Extended Documentation.
• GitHub wiki.

Contact

To report a bug, contribute, discuss on usage, or simply request support, please create an issue here.

You can also contact me on Twitter: @fortysevenfx.

License

MIT © 2009 - present Francois Best