python-rtmidi

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

These details have not been verified by PyPI

Project links

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 & Kernel Streaming) 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).

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.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

1.5.8

Nov 20, 2023

1.5.7

Oct 24, 2023

1.5.6

Sep 12, 2023

1.5.5

Jul 26, 2023

1.5.4

Jun 27, 2023

1.5.3

Jun 23, 2023

1.5.2

Jun 14, 2023

1.5.1

Jun 12, 2023

1.5.0

May 23, 2023

1.4.9

Apr 26, 2021

1.4.8

Apr 26, 2021

1.4.7

Jan 27, 2021

1.4.6

Oct 15, 2020

1.4.5

Aug 26, 2020

1.4.4 yanked

Aug 26, 2020

Reason this release was yanked:

Install error with Python 2 and/or old setuptools versions

1.4.3

Aug 11, 2020

1.4.2

Jul 18, 2020

1.4.1

Apr 16, 2020

1.4.0

Jan 19, 2020

1.3.1

Oct 15, 2019

1.3.0

Apr 15, 2019

1.2.1

Jan 18, 2019

1.2.1rc1 pre-release

Jan 18, 2019

1.2.0

Jan 13, 2019

1.2.0rc2 pre-release

Jan 12, 2019

1.2.0rc1 pre-release

Oct 11, 2018

1.1.2

Oct 10, 2018

1.1.2rc2 pre-release

Oct 9, 2018

1.1.1

Aug 6, 2018

1.1.0

Apr 21, 2017

1.0.0

Nov 7, 2016

1.0.0rc1 pre-release

Oct 9, 2016

0.5b1 pre-release

Jun 11, 2014

This version

0.4.3b1 pre-release

Nov 10, 2013

0.4.2b pre-release

Nov 7, 2013

0.4.1b pre-release

Nov 5, 2013

0.4b pre-release

Nov 5, 2013

0.3.1a pre-release

Jan 23, 2013

0.3a pre-release

Jan 14, 2013

0.2a pre-release

Jul 22, 2012

0.1a pre-release

Jul 13, 2012

Download files

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