A midi listener that can be programmed to execute commands based on midi CC values
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.




A midi listening device to execute pre-programmed commands based on MIDI control change messages.

import time
import mido
import os
import re

Also requires 'amidithru'

The script creates a virtual midi device (MidiCmdServer), and listens to it for incoming midi control change messages.

In the script, you can add control change identifiers, values, and the desired command to run, along with an optional uptime restriction. You will find this section around line 32 or so:

# set up midi commands here
# midi_cmd( cc, cc_val, command, optional uptime seconds restriction) 
midi_cmd(64, 127, "echo '64 on' >> /tmp/test", 120)
# this would be the shutdown server functionality here
#midi_cmd(64, 127, "init 0", 120)
midi_cmd(64, 0,   "echo '64 off' >> /tmp/test")

Generally, add an entry to your crontab to call the script on startup: (Make sure you set your path properly)

@reboot /usr/bin/sudo /path/to/midi_cmd_server.py &

Note about sudo

This script requires root to run, so you need to call it with sudo, without a password, or save the startup under the root crontab without the need for sudo.

To have this work on boot with sudo, you must not have sudo require a password to work.

You can achieve this by adding a new file and rule to your sudoers config. with visudo (username modep in examples):

sudo visudo -f /etc/sudoers.d/modep

Once in visudo, write the sudoers rule to allow your user to run sudo without a password:


After that, you can log out and back in or reboot, and then be able to run sudo things without a password.