mdmi-cli 0.5.0

CLI tool for working with the Mega Drive MIDI Interface (MDMI)

Mega Drive MIDI Interface CLI

CLI for controlling the Mega Drive MIDI Interface (MDMI). Helps you load presets from instrument files, clear presets, list WOPN instruments, and test connectivity.

Features

• Load presets from instrument files:
  • DefleMask preset versions 8, 9 and 11
  • WOPN versions 1 and 2, as used by libOPNMIDI
  • TFI
• Clear presets. Individual user presets or all presets at once
• List WOPN instruments
• Connectivity testing: Ping/pong functionality to test MDMI connectivity

Installation

Latest version from PyPI:

pip install mdmi-cli

Usage

Load a preset

# Load TFI preset to program 0 (uses MDMI_MIDI_OUT if set)
mdmi load-preset example.tfi --program 0

# Load DMP preset to program 5 via specific MIDI port
mdmi load-preset example.dmp --program 5 --midi-out "IAC Driver Bus 1"

# Load specific WOPN instrument to program 10
mdmi load-preset soundbank.wopn --program 10 --bank 0 --instrument 5 --bank-type melody

# Test with fake interface (for development)
mdmi load-preset example.tfi --program 0 --dry-run

WOPN file management

# List contents of a WOPN file (first 10 instruments per bank)
mdmi list-wopn soundbank.wopn

# List all instruments in WOPN file
mdmi list-wopn soundbank.wopn --full

# Load percussion instrument from WOPN
mdmi load-preset soundbank.wopn --program 20 --bank 0 --instrument 3 --bank-type percussion

# Load from different melody bank
mdmi load-preset soundbank.wopn --program 15 --bank 1 --instrument 65 --bank-type melody

Clear presets

# Clear preset at program 5 (uses MDMI_MIDI_OUT if set)
mdmi clear-preset --program 5

# Clear all presets (with confirmation)
mdmi clear-all-presets

# Clear all presets (skip confirmation) with specific port
mdmi clear-all-presets --confirm --midi-out "IAC Driver Bus 1"

Test connectivity

# Test MDMI connectivity with ping/pong
mdmi ping

# Test with custom timeout
mdmi ping --timeout 10.0

# Test with specific ports
mdmi ping --midi-out "IAC Driver Bus 1" --midi-in "IAC Driver Bus 2"

List available MIDI ports

# List all available MIDI input and output ports
mdmi list-ports

Configuration

Environment Variables

• MDMI_MIDI_OUT: Default MIDI output port name
• MDMI_MIDI_IN: Default MIDI input port name
• MDMI_MIDI_PORT: Legacy fallback for MIDI output port

Command-line Options

Most commands support:

• --midi-out TEXT: MIDI output port name (overrides environment variables)

Commands with bidirectional communication (ping) also support:

• --midi-in TEXT: MIDI input port name (overrides MDMI_MIDI_IN)

Development

Build

# Install cli (from source)
make install

# Run tests
make test