Need help with Arduino-AppleMIDI-Library?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

lathoub
196 Stars 59 Forks Other 717 Commits 0 Opened issues

Description

Send and receive MIDI messages over Ethernet (rtpMIDI or AppleMIDI)

Services available

!
?

Need anything else?

Contributors list

# 125,771
C
arduino...
Arduino
c-plus-...
480 commits
# 346,814
C++
Arduino
c-plus-...
homebri...
6 commits
# 168,686
Shell
C
arduino...
Arduino
3 commits
# 22,525
Arduino
C
iot-fra...
qr-gene...
1 commit
# 76,158
C++
Arduino
Objecti...
Shell
1 commit
# 158,143
C
arduino...
Arduino
c-plus-...
1 commit
# 42,247
udacity...
xslt
laravel...
scrapy-...
1 commit
# 2,178
blockly
openfra...
pipelin...
simbl
1 commit

AppleMIDI (aka rtpMIDI) for Arduino

arduino-library-badge Build Status 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

  • Build on top of the popular FortySevenEffects MIDI library
  • Tested with AppleMIDI on Mac OS (Big Sur) and using rtpMIDI 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)

New in 3.0.0

  • Bug Fixes (long session names get cropped)
  • Reduced memory footprint (see AVR_MinMemUsage example and note below)
  • Extended and revised callbacks to receive AppleMIDI protocol feedback (see AVR_Callbacks example)
  • Who may connect to me (Directory) (see AVR_Directory example) ### New in 3.1.0
  • Increased stability in high-throughput situations
  • Updated wiki ### New in 3.1.1 and 3.1.2
  • Bug fixes en enhancements

Installation

From the Arduino IDE Library Manager, search for AppleMIDI

Installation

This will also install FortySevenEffects MIDI library

Basic Usage

#include 
#include 

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); } } </applemidi.h></ethernet.h>

More usages in the examples folder and in the wiki

Hardware

  • 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 W5500 Setup
  • Teensy 3.2 & 4.1
  • Adafruit Feather M0 WiFi - ATSAMD21 + ATWINC1500

Network Shields

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

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)

  • 1.8.16

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.