Home

Awesome

AppleMIDI (aka rtpMIDI) for Arduino License: CC BY-SA 4.0

Enables an Arduino with IP/UDP capabilities (Ethernet shield, ESP8266, ESP32, ...) to participate in an AppleMIDI session.

Important: Please read the note below on enlarging the standard Ethernet library buffersize to avoid dropping MIDI messages!

Features

New in 3.2.0

New in 3.3.0

Installation

From the Arduino IDE Library Manager, search for AppleMIDI

<img width="786" alt="Installation" src="https://github.com/lathoub/Arduino-AppleMIDI-Library/blob/master/res/Install3-1.PNG">

This will also install FortySevenEffects MIDI library

Basic Usage

#include <Ethernet.h>
#include <AppleMIDI.h>

byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };

APPLEMIDI_CREATE_DEFAULTSESSION_INSTANCE(); 

void setup()
{
  Ethernet.begin(mac);

  MIDI.begin(); // listens on channel 1
}

void loop()
{
  // Listen to incoming notes
  MIDI.read();
  
  ....
  if (something) {
    // Send MIDI note 40 on, velocity 55 on channel 1
    MIDI.sendNoteOn(40, 55, 1);
  }
}

More usages in the examples folder and in the wiki

Hardware

Network Shields

Notes

Session names

Session names can get really long on Macs (eg 'Macbook Pro of Johann Gambolputty .. von Hautkopft of Ulm') and will be truncated to the MaxSessionNameLen

Memory footprint

The memory footprint of the library can be lowered significantly, read the wiki

Ethernet buffer size

It's highly recommended to modify the Ethernet library or use the Ethernet3 library to avoid buffer overruns - learn more

Latency

Use wired Ethernet to reduce latency, Wi-Fi increases latency and latency varies. More of the wiki

Arduino IDE (arduino.cc)

Contributing

I would love to include your enhancements or bug fixes! In lieu of a formal styleguide, please take care to maintain the existing coding style. Please test your code before sending a pull request. It would be very helpful if you include a detailed explanation of your changes in the pull request.