Troubleshooting: MIDI assignment not working

A MIDI input isn't triggering the command you assigned it to.

1. Is "Listen" enabled for the device?

KTPlayer needs to be told to 'listen' for commands. By default, every device is off until you enable it.

1. Open Preferences → Devices → MIDI devices (⌘,    ).
2. Find your MIDI device in the Input device list.
3. Confirm the Listen checkbox is ticked.
4. If you've just ticked it, try the MIDI trigger again.

2. Is the device recognized by macOS?

If the device doesn't appear in Preferences → Devices → MIDI devices at all, KTPlayer can't see it because macOS hasn't either.

1. Open Audio MIDI Setup (Spotlight → "Audio MIDI Setup").
2. Window → Show MIDI Studio.
3. Confirm your MIDI device appears.
4. If not, check the cable, try a different USB port, or restart the Mac with the device connected at boot.

3. Is the assignment in place?

The MIDI signal needs to be assigned to a specific command.

1. Open Preferences → Assignments.
2. Find the command you expected to trigger (Go, Stop, Up, etc.).
3. Confirm the MIDI column shows an assigned message, not None    .
4. If None    , click the row to select it, then click Learn beside the MIDI field, and send the MIDI message from your device. The assignment fills in.

4. Is the MIDI device sending a message type KTPlayer accepts?

KTPlayer accepts only Note On and Control Change (CC) messages. See MIDI Input reference.

1. Use a MIDI monitoring tool (such as MIDI Monitor from Snoize) to see what your device is sending when you trigger it.
2. If it's a Note On or CC, it should assign normally. Go back to Is the Assignment in place?
3. If it's anything else (Note Off, Program Change, SysEx), it can't be used directly to trigger a command. However you can use a utility such as MIDI Pipe or MIDI Fire to convert it to a Note On or CC, then assign that.

5. Has the assignment table refreshed?

The assignment table sometimes doesn't visibly update after a Clear or Learn. The change is applied; the table just doesn't redraw.

1. Click a different row in the assignment table.
2. Click back to the row you were editing.
3. The assignment should now display correctly.

Still not working?

1. Restart KTPlayer.
2. Restart the Mac with the MIDI device connected.
3. Test with a different MIDI device, which isolates whether it's the device or KTPlayer.

If the problem continues, contact KeyboardTEK (support@keyboardtek.com) with your macOS version, the MIDI device make and model, the assignment you're trying to set up, and the result of testing in MIDI Monitor.