KeyMaster

KeyMaster is similar to PatchMaster, but it's for Mac OS X only and is written in Objective C.

I wrote a native Mac app because when playing through PatchMaster, I was getting lag. KeyMaster uses the Mac's native MIDI framework as wrapped by Pete Yandell's excellent PYMIDI library.

Documentation

The online documentation for KeyMaster includes detailed explanations, a tutorial, tips and tricks, and more.

Building

make

Running

./keymaster examples/example.km

Testing

make test

Testing Setup

(FIX THIS DESCRIPTION) Before you run the tests, you'll have to copy or link the SenTestingKit framework to somewhere like /System/Library/Frameworks. I can't figure out how to set @rpath at runtime. I've tried using DYLD_LIBRARY_PATH and a few other things. For tests to run properly, I link the framework in to /System/Library/Frameworks. You can do that, or copy the directory instead of linking, or figure out how to set @rpath (and tell me, please).

To create a link:

sudo ln -s \
    /Applications/Xcode.app/Contents/Developer/Library/Frameworks/XCTest.framework \
    /System/Library/Frameworks/XCTest.framework

Bugs

No known bugs. If that doesn't tempt fate, I don't know what will.

To Do

• More documentation
• More complex filters
• Better example with better comments
• Aliases
• Named Messages and Message Keys

Thanks

KeyMaster uses PYMIDI (http://github.com/notahat/pymidi) by Pete Yandell. PYMIDI is released under the MIT license, a copy of which can be found in src/PYMIDI/MIT-LICENSE.