Settings & Configuration

Complete settings reference for Neurode MIDI.

General Settings

Appearance

• Theme — Light, Dark, or Auto (follow system)
• Default View — Dashboard, Flow Graph, or Unified
• Panel Layout — Adjust relative panel sizes
• Compact Mode — Reduce padding for denser layout

Behaviour

• Auto-Save — Save routing changes automatically (recommended: ON)
• Confirm Delete — Ask before deleting routes
• Default Route Name — Template for new route names
• Activity Timeout — How long to show "active" indicator after last message

Virtual Ports

Create and manage software MIDI endpoints.

• Add Port — Create new virtual port
• Port Type — Source or Destination
• Port Name — How it appears to other apps
• Enable/Disable — Temporarily disable port

See Virtual Ports for details.

Bluetooth

Bluetooth MIDI lets you pair BLE MIDI devices directly in the app.

• Bluetooth MIDI — Open the Bluetooth pairing and connection screen
• Scan for Devices — Search for nearby Bluetooth MIDI devices
• Connect / Disconnect — Pair a nearby BLE MIDI controller, keyboard, or instrument

Current scope:

• Connected Bluetooth devices appear as Sources
• Devices with writable BLE MIDI characteristics also appear as Destinations
• Incoming and outgoing BLE MIDI use the same routing engine as wired and virtual endpoints
• Auto-reconnect, battery indicators, and timeout controls are not available yet

See Bluetooth MIDI for details.

Clock & Sync

Configure tempo and timing.

Clock Generator

• Enable — Generate internal MIDI clock
• Tempo (BPM) — Clock rate (30-300 BPM)
• Send Start/Stop — Include transport messages

Clock Follower

• Source — Which device to follow for tempo
• Smoothing — Filter clock jitter
• Auto-Detect — Automatically detect incoming clock

See Clock & Sync for details.

Profiles

Save and load routing configurations.

• Current Profile — Active profile name
• Save Profile As... — Store current routing setup
• Load Profile — Switch to saved configuration
• Export Profile — Save as file for backup/sharing
• Import Profile — Load profile from file

Use cases:

• Stage vs Studio vs Practice setups
• Different projects
• Backup configurations

Performance

Optimize for latency and CPU usage.

Threading

• Realtime Priority — High priority for routing threads (recommended: ON)
• Background Monitoring — Lower priority for visualization (recommended: ON)

Visualization

• Flow Graph FPS — Limit framerate to save CPU (30, 60, or Unlimited)
• Activity Animation — Enable/disable pulse animations
• Clock Pulse Visualization — Show/hide clock tick pulses

Statistics

• Track Latency — Monitor per-route latency (slight overhead)
• Track Message Counts — Count messages per route
• Performance Profiling — Detailed per-transform timing (high overhead, use sparingly)

Advanced

AI Companion

Not included in this release

Elm (the AI Companion) is experimental and excluded from App Store builds by default in this release. These settings do not appear in the current public build.

• Enable — Turn on AI-generated accompaniment
• Model — Select trained model
• Latency/Quality — Trade-off slider
• Destinations — Where to send AI output

See AI Companion for details.

Advanced Options

Diagnostic controls for troubleshooting and performance monitoring.

• Troubleshooting Mode — Detailed logging and diagnostics
• Script Debugging — Step-through script execution
• Raw MIDI Log — Log all MIDI messages to console
• Performance Overlay — Show FPS and latency on screen

Data & Privacy

Neurode MIDI has no analytics, no crash-reporting network calls, and no telemetry of any kind — see the Privacy Policy for details.

• Clear Cache — Reset cached data
• Reset All Settings — Return to defaults

Keyboard Shortcuts (macOS)

Action	Shortcut
Settings	⌘,
Profiles	⌘⇧P
Virtual Ports	⌘⇧V
Bluetooth	⌘⇧B

Storage & Backup

Data Location

• macOS: ~/Library/Application Support/Neurode MIDI/
• iOS: App sandbox

Backup Recommendations

• Export profiles regularly
• iCloud sync enabled (iOS)
• Time Machine includes app data (macOS)

Next Steps

• Profiles — Using profiles effectively
• Performance Optimization — Tune for best latency
• Troubleshooting — Fix common issues