Platform-Specific Setup
Neurode MIDI uses the same routing engine on macOS, iPhone, and iPad, while adapting connection and presentation details to each platform.
App Store status
Neurode MIDI 1.0.1 has been submitted for Mac, iPhone, and iPad and is awaiting App Store review. Download links will be added after approval.
Requirements
| Platform | Minimum operating system |
|---|---|
| macOS | macOS 15.0 or later |
| iPhone | iOS 18.0 or later |
| iPad | iPadOS 18.0 or later |
A compatible MIDI source or destination is optional: you can begin with Neurode MIDI's virtual endpoints and keyboard.
macOS setup
First launch
- Open Neurode MIDI.
- Complete onboarding.
- Open Routing and confirm the expected CoreMIDI endpoints appear.
- If you connect an endpoint later, use MIDI → Refresh Devices or press Command-Shift-R.
Connect a DAW with IAC Driver
The macOS IAC Driver creates virtual MIDI ports between apps.
- Open Audio MIDI Setup.
- Choose Window → Show MIDI Studio.
- Open IAC Driver and enable Device is online.
- Add a bus if needed.
- Select that bus as the DAW's MIDI output and as a source in Neurode MIDI, or reverse the direction for DAW input.
Avoid routing an IAC bus back into itself; that creates a MIDI feedback loop.
User NeuroScript examples
In the route editor, open Examples, then select Open Presets Folder. The browser discovers top-level .ns files in that directory. Subfolders are not scanned.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
| Command-Shift-R | Refresh MIDI devices |
| Command-Shift-. | Panic (All Notes Off) |
| Command-? | Open Neurode MIDI Help |
The current app uses one main window and removes the standard New Window command. Do not plan a workflow that depends on separate independent routing windows.
iPhone and iPad setup
First launch
- Open Neurode MIDI.
- Allow Bluetooth if you will use Bluetooth MIDI.
- Allow Local Network if you will use network MIDI discovery.
- Complete onboarding and open Routing.
USB MIDI
iOS and iPadOS support class-compliant USB MIDI through CoreMIDI. Use a connector-appropriate USB adapter or hub when the device cannot plug in directly. Some bus-powered interfaces need a powered hub.
After connecting the device, wait briefly and refresh MIDI devices if it does not appear.
Bluetooth MIDI
- Put the MIDI device in pairing mode.
- Open Settings → Connectivity → Bluetooth MIDI in Neurode MIDI.
- Select the device and wait for it to move under Connected Devices.
- Return to Routing and use the discovered source or destination.
Bluetooth latency depends on the device, distance, radio conditions, and other nearby traffic.
Network MIDI
- Open Settings → Connectivity.
- Enable Network Session and choose a policy.
- Configure or initiate the RTP-MIDI connection from the other host.
- Return to Routing and refresh endpoints if necessary.
See Network MIDI for details.
Route-preset transfer
The route editor can import and export Neurode preset JSON. On iOS, it can also show or scan a preset QR code. The current release does not expose the user .ns Presets directory as a documented Files-app library and does not provide profile import.
Background routing
On iOS and iPadOS, Settings → Performance → Enable Background Routing is opt-in. The app reports whether the current runtime state needs attention. Always test background behaviour on the actual device and connection used for a performance; operating-system suspension and accessory behaviour cannot be guaranteed by documentation.
iPad presentation
iPad supports the regular adaptive app layout. The Event Visualizer can open an external-display scene when a display is available. The external scene is for the visualizer, not a second routing matrix.
Feature comparison
| Feature | macOS | iPhone/iPad |
|---|---|---|
| Wired class-compliant MIDI | Yes | Yes, adapter or hub may be required |
| Bluetooth MIDI | Yes | Yes |
| Network MIDI | Yes | Yes |
| Virtual endpoints | Yes | Yes |
| Open user Presets folder in Finder | Yes | No |
| Route-preset JSON import/export | Yes | Yes |
| Route-preset QR transfer | No | Yes |
| Optional background routing | Not applicable | Yes |
| Event Visualizer external display | When a display scene is available | When a display scene is available |
| Multiple independent app windows | No | No |
Troubleshooting
A device does not appear
- Confirm it appears to the operating system or other MIDI software.
- Check the cable, adapter, hub power, Bluetooth connection, or network session.
- Refresh MIDI devices.
- Disconnect and reconnect the endpoint.
Notes remain active after a disconnect
Use Panic (All Notes Off), then reconnect the endpoint and test Note On, Note Off, and sustain before resuming.
The interface is crowded
Switch between Tabbed and Unified layout in Settings. On iPhone, Tabbed mode is usually the clearest; larger iPad and Mac displays can make effective use of Unified mode.