myMIDI Ultra — Help & Troubleshooting Guide
myMIDI Ultra is a flexible MIDI controller and monitor for iPhone, iPad, and Apple Watch. It can send and receive MIDI over Network MIDI (RTP‑MIDI), USB MIDI, and raw MIDI over UDP (via the companion myMIDI Bridge app on macOS).
This guide walks through the basics, common questions, and fixes for the issues most users run into.
Table of Contents
Getting Started
- Launch myMIDI Ultra. Network MIDI is enabled automatically on first launch.
- Tap the + button in the toolbar and choose an object type to add to your show.
- Tap a card to send (notes, MSC, custom SysEx), drag a slider (CC, Program, Pitch Bend, Aftertouch), or open a Monitor / Time Code object to watch incoming traffic.
- Open Settings (gear icon) to pick your MIDI output destination and adjust network options.
- The two LEDs at the bottom of the main screen (IN / OUT) flash green/blue whenever MIDI is received or sent — a quick way to confirm your signal is flowing.
MIDI Object Types
Tap + to add any of the following:
| Object | What it does |
|---|---|
| Send MIDI Note | Tap the card to fire a note. Editable channel (1–16), note number (0–127), velocity, and duration. |
| Send MIDI Show Control | Sends an MSC SysEx cue. Configure device ID (0–127), command format (lighting, sound, video, …), command (GO, STOP, RESUME, FIRE, …), cue number, list, and path. |
| Send Custom SysEx | Sends an arbitrary System Exclusive message you define byte‑by‑byte. |
| Control Change Slider | Drag to send CC values 0–127 continuously on the selected channel and CC number. |
| Program Change Slider | Drag to send Program Change 0–127. |
| Pitch Bend Slider | Drag to send 14‑bit Pitch Bend values 0–16383. |
| Aftertouch Slider | Drag to send channel pressure 0–127. |
| MIDI Monitor | Watches every connected MIDI source and lists incoming messages in real time. |
| MIDI Time Code | Reassembles incoming MTC quarter‑frame messages into a live HH:MM:SS:FF display. |
Tap the pencil icon on any card (or use the context menu) to edit it.
Customizing Your Layout
- Grid vs. List — toggle in the top toolbar. Grid lets cards of different sizes flow and wrap; List shows them stacked with optional drag‑to‑reorder.
- Card size — each card can be set to Small, Medium, or Large. Set the default for new cards in Settings → Layout → Default Card Size.
- Color — pick a color per card from the editor.
- Reordering — long‑press a card and choose Move Up / Move Down, or use the edit pencil in List mode to drag.
Saving and Sharing Shows
Your current layout is auto‑saved between launches. To create a backup, share with another device, or keep multiple set lists:
- Save Show… — exports the entire show as a
.showfile (JSON). - Open Show… — imports a previously saved
.show(or compatible.json) file. - New Show — clears the current layout. (Save first if you want to keep it.)
- Rename Show — changes the name shown in the title bar and used as the default filename when exporting.
All show actions live under the document menu in the top‑left corner of the main screen.
Connecting to a Mac via Network MIDI
myMIDI Ultra uses Apple’s standard MIDI Network Session (RTP‑MIDI), so no extra software is required on the Mac.
- On your Mac, open Audio MIDI Setup (Applications → Utilities → Audio MIDI Setup).
- Choose Window → Show MIDI Studio (⌘2).
- Double‑click the Network icon to open MIDI Network Setup.
- Under My Sessions, click + to create a new session and enable its checkbox. Note the Bonjour name and port.
- Make sure your iOS device and your Mac are on the same Wi‑Fi network.
- Launch myMIDI Ultra. Your device should appear in the Directory list on the Mac.
- Select your device in the Directory and click Connect. The connection appears under Participants.
- Under Live routings, set Who may connect to me to Anyone (or set explicit access).
- Back in myMIDI Ultra, open Settings and pick the Network Session as your MIDI Output destination. Incoming MIDI from the Mac is auto‑monitored.
Connecting a USB MIDI Device
Plug the device into your iPhone or iPad using:
- USB‑C iPad / iPhone — a USB‑C to USB‑A adapter or hub.
- Lightning — Apple’s Lightning to USB Camera Adapter (or the powered Camera Adapter for higher‑power devices).
Class‑compliant MIDI devices appear automatically in Settings → MIDI Destinations and as auto‑monitored MIDI Sources. Tap Refresh if a newly plugged device does not appear immediately.
Raw MIDI over UDP (myMIDI Bridge)
For low‑level integrations — or when you need MIDI to travel as raw datagrams between this device and a Mac running the myMIDI Bridge helper app — use the Raw MIDI over UDP section in Settings.
Sending raw MIDI
- Open Settings → Raw MIDI over UDP.
- Enter the Host (the IP address of the device you’re sending to; use
127.0.0.1only when you intend to loop back to the same device). - Enter the Port the receiver is listening on.
- Toggle Send Raw MIDI over UDP on. Every message myMIDI Ultra sends will now be duplicated as a UDP datagram to the configured host/port.
Receiving raw MIDI
- Find This Device’s IP at the top of the Raw MIDI section — that’s the address senders should target.
- Set a Bind Address (leave at
0.0.0.0to accept datagrams on any local interface) and a Port. - Toggle Listen for Raw MIDI over UDP on. Incoming datagrams are parsed, shown in the Monitor, and flash the IN LED.
Tip: Settings fields are disabled while UDP send/listen is on. Toggle off, edit, then toggle back on.
Apple Watch App
myMIDI Ultra includes a companion Watch app that mirrors a simplified version of your show:
- The Watch automatically syncs from the iPhone using WatchConnectivity. Make sure the watch is paired, the iPhone app has been launched at least once, and both devices are nearby.
- On the watch, choose List or Grid layout via the toolbar.
- Tap an object to trigger it (notes, MSC, SysEx) or open the detail view to drag sliders.
- If the watch shows no objects, open the iPhone app once, then re‑open the watch app to force a fresh sync.
Troubleshooting
Nothing is happening when I tap a card
- Open Settings and confirm the Output picker is set to a real destination (not “No destinations available”).
- Tap Refresh in the MIDI Destinations section.
- Watch the OUT LED at the bottom of the screen — if it flashes, MIDI is leaving the app and the issue is downstream (receiving software, cable, channel mismatch).
- Check that the receiving software is listening on the same MIDI channel as the card.
The Mac doesn’t see my iPhone/iPad in Audio MIDI Setup
- Both devices must be on the same Wi‑Fi network and subnet. Guest networks and “client isolation” Wi‑Fi modes block Bonjour discovery.
- Toggle Settings → MIDI Network Session off and on inside myMIDI Ultra.
- On the Mac, quit and relaunch Audio MIDI Setup, or click the Network icon’s Refresh equivalent (close and reopen the MIDI Network Setup window).
- VPNs, firewalls, and “Private Wi‑Fi Address” set per‑network can interfere. Try disabling them as a test.
- iOS Local Network permission must be granted to myMIDI Ultra. If you previously denied it, enable it in iOS Settings → Privacy & Security → Local Network → myMIDI Ultra.
My USB MIDI device isn’t showing up
- Make sure the device is class‑compliant (most modern MIDI keyboards and interfaces are).
- High‑power devices may need Apple’s powered Lightning to USB adapter, or external power via a powered USB hub on USB‑C.
- Tap Settings → MIDI Destinations → Refresh after plugging in.
- Try a different cable/adapter — many issues are physical.
Raw MIDI over UDP isn’t reaching the other device
- Verify both devices are on the same network and that nothing (firewall, VPN, “Lockdown Mode”) is dropping UDP.
- Double‑check the Host field on the sender matches the IP shown at the top of the receiver’s Raw MIDI section.
127.0.0.1only ever talks to the same device. - Sender’s destination Port must match the receiver’s listen Port.
- Toggle the UDP switch off and back on after editing host/port.
I see incoming MIDI in the Monitor but my Time Code object stays at 00:00:00:00
MIDI Time Code uses MTC quarter‑frame messages (status byte 0xF1). If your source is sending SMPTE LTC audio, MMC, or a song‑position pointer instead, the Time Code view won’t update. Confirm the sender is configured to transmit MTC quarter‑frame.
My show file won’t open
- The file must be a
.show(or compatible.json) exported by myMIDI Ultra. - Files synced from another device through iCloud may need a moment to download fully before they can be opened — open the Files app first and confirm the file is downloaded.
- If a file fails to import, the error message appears in Settings → Status.
I made a mistake — can I undo?
There’s no full undo stack, but:
- Use Save Show… before any major edit to keep a backup you can re‑open.
- If you accidentally cleared your show, look for the most recent
.showfile in the Files app where you previously saved.
The app feels sluggish with many cards
Very large shows with hundreds of cards can slow scrolling on older devices. Try switching to List layout (lighter to render) and reducing card size to Small.
The Apple Watch app is blank or out of date
- Open the iPhone app, then reopen the watch app to push a fresh sync.
- Make sure the watch and phone are within Bluetooth range or on the same Wi‑Fi.
- As a last resort, force‑quit both apps and relaunch.
Contact & Support
If you’ve worked through this guide and your issue isn’t resolved, please send a message including:
- Your iOS and app version
- The device model (iPhone, iPad, Watch)
- A short description of what you were doing and what you expected to happen
- Whether the IN / OUT LEDs flashed when the issue occurred
- Any error message shown in Settings → Status
We’ll get back to you as quickly as we can. Thanks for using myMIDI Ultra!