Repository files navigation

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

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

• Build on top of the popularFortySevenEffects MIDI library
• Tested with AppleMIDI on Mac OS (Big Sur) and usingrtpMIDI from Tobias Erichsen on Windows 10
• Send and receive all MIDI messages
• Uses callbacks to receive MIDI commands (no need for polling)
• Automatic instantiation of AppleMIDI object (see at the end of 'AppleMidi.h')
• Compiles on Arduino, MacOS (XCode) and Windows (MSVS)

• Event chaining

• Better parsing of large incoming MIDI messages with a small internal Arduino buffer

From the Arduino IDE Library Manager, search for AppleMIDI

This will also installFortySevenEffects MIDI library

#include<Ethernet.h>#include<AppleMIDI.h>byte mac[] = {0xDE,0xAD,0xBE,0xEF,0xFE,0xED };APPLEMIDI_CREATE_DEFAULTSESSION_INSTANCE();voidsetup(){  Ethernet.begin(mac);  MIDI.begin();// listens on channel 1}voidloop(){// 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 theexamples folder and in thewiki

• Arduino/Genuino (Mega, Uno, Arduino Ethernet, MKRZERO, ...)
• ESP8266 (Adafruit HUZZAH ESP8266, Sparkfun ESP8266 Thing Dev)
• ESP32 (Adafruit HUZZAH32 – ESP32 Feather Board) Wi-Fi
• ESP32 with W5500Setup
• Teensy 3.2 & 4.1
• Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

• Arduino Ethernet shield (Wiznet W5100 and W5500)
• Arduino Wifi R3 shield
• MKR ETH shield (W5500 and W6100 based)
• Teensy WIZ820io W5200
• Teensy 4.1 withEthernet Kit

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

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

It's highly recommended to modify theEthernet library or use theEthernet3 library to avoid buffer overruns -learn more

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

• 1.8.16

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.