Skip to main content

A Python wrapper for the RtMidi C++ library written with Cython.

Project description

RtMidi is a set of C++ classes which provides a concise and simple, cross-platform API (Application Programming Interface) for realtime MIDI input/output across Linux (ALSA & JACK), Macintosh OS X (CoreMIDI & JACK), and Windows (MultiMedia Library) operating systems.

python-rtmidi is a Python binding for RtMidi implemented with Cython and provides a thin wrapper around the RtMidi C++ interface. The API is basically the same as the C++ one but with the naming scheme of classes, methods and parameters adapted to the Python PEP-8 conventions and requirements of the Python package naming structure. python-rtmidi supports Python 2 (tested with Python 2.7) and Python 3 (3.3, 3.4, 3.5).

Usage example

Here’s a quick example of how to use python-rtmidi to open the first available MIDI output port and send a middle C note on MIDI channel 1:

import time
import rtmidi

midiout = rtmidi.MidiOut()
available_ports = midiout.get_ports()

if available_ports:
    midiout.open_port(0)
else:
    midiout.open_virtual_port("My virtual output")

note_on = [0x90, 60, 112] # channel 1, middle C, velocity 112
note_off = [0x80, 60, 0]
midiout.send_message(note_on)
time.sleep(0.5)
midiout.send_message(note_off)

del midiout

More usage examples can be found in the tests and examples directory of the source distribution. API documentation is available by looking at the docstrings in the Cython source code src/_rtmidi.pyx or using tools like pydoc or IPython and by reading the (somewhat terse and inaccurate) RtMidi documentation.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
python_rtmidi-1.0.0-cp27-cp27m-win32.whl (59.0 kB) Copy SHA256 hash SHA256 Wheel cp27
python_rtmidi-1.0.0-cp27-cp27m-win_amd64.whl (68.1 kB) Copy SHA256 hash SHA256 Wheel cp27
python_rtmidi-1.0.0-cp34-cp34m-win32.whl (64.7 kB) Copy SHA256 hash SHA256 Wheel cp34
python_rtmidi-1.0.0-cp34-cp34m-win_amd64.whl (70.0 kB) Copy SHA256 hash SHA256 Wheel cp34
python_rtmidi-1.0.0-cp35-cp35m-win32.whl (62.5 kB) Copy SHA256 hash SHA256 Wheel cp35
python_rtmidi-1.0.0-cp35-cp35m-win_amd64.whl (70.3 kB) Copy SHA256 hash SHA256 Wheel cp35
python-rtmidi-1.0.0.tar.bz2 (162.7 kB) Copy SHA256 hash SHA256 Source None
python-rtmidi-1.0.0.tar.gz (185.4 kB) Copy SHA256 hash SHA256 Source None
python-rtmidi-1.0.0.zip (211.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page