KLO MIDI Tools

A lightweight MIDI utility for monitoring and testing MIDI devices.

Features

• Connect MIDI input and output devices
• Auto-connect when a single device is plugged in
• Live port detection — reconnects and disconnects are logged automatically
• 1-octave piano visualizer showing incoming notes with velocity-dependent color (blue → red)
• Pitch bend and mod wheel indicators
• Send and hold notes with configurable note, velocity, and channel
• Sustain pedal toggle
• Panic button (all notes off on all 16 channels)
• Timestamped message log

Running from source

# Create and activate a conda environment
conda create -n midi python=3.11
conda activate midi

# Install dependencies and the local app command
pip install -e .

# Run
klo-midi-tools

You can also run without installing the console script:

python -m klo_midi_tools

Project layout

src/klo_midi_tools/          application package
src/klo_midi_tools/assets/   bundled fonts and icons
.github/workflows/          release build automation

settings.json is generated locally when the app saves preferences and is ignored by Git.

Download

Pre-built binaries are available under Actions for every commit — download the artifact for your platform.

• macOS — extract the zip and open KLO MIDI Tools.app
• Windows — run KLO MIDI Tools.exe (SmartScreen may warn on first launch — click More info → Run anyway)

Dependencies

• python-rtmidi — MIDI I/O
• Dear PyGui — GUI