Home

SysEx Librarian



Source Code

The source code for SysEx Librarian can be downloaded here.

The code is released under the BSD license. See the LICENSE file in the source code for the legal details.

This is the source code for the entire application. You do NOT need any of this if you just want to use the application. You only need the source if you want to play with the code, customize the application, or use parts of the code in your own project.



What's Included

Everything you need to build SysEx Librarian is here. You should have a source tree that looks like this:

  • SysEx Librarian Source
    • Applications
      • SysExLibrarian
    • Frameworks
      • SnoizeMIDI
    • Configurations
    • Scripts

In decreasing order of importance:

Applications/SysExLibrarian

The source to the SysEx Librarian application. The project file is SysExLibrarian.xcodeproj; open this using Xcode.

SysEx Librarian is a Cocoa application, written in Objective-C.

The application relies on the other frameworks, described below.

Frameworks/SnoizeMIDI

A framework containing code for dealing with CoreMIDI in a Cocoa app:

  • Creating a CoreMIDI client
  • Finding MIDI devices, sources, and destinations
  • Creating "streams" of input and output data, and hooking them up to inputs and outputs
  • Parsing MIDI streams into separate MIDI messages
  • Dealing with older versions of CoreMIDI (from 10.1 onwards)

This framework is used by both SysEx Librarian and my other application, MIDI Monitor. You should be able to use it in your own applications as well.

The code is mainly Objective-C, with one ordinary C file.

Configurations

Contains Xcode configuration files which are shared between the various different Xcode projects.

Scripts

Contains a script to build the final ("install") version of SysEx Librarian.



How To Build

The projects enclosed are for Xcode 2.2. You may be able to use the projects in earlier versions of Xcode, but no guarantees (that's up to you -- I haven't tried it myself).

The code will work on OS X 10.2 and later. It builds using the 10.2.8 SDK; if you didn't install this SDK along with Xcode, you will probably want to. Intel builds use the 10.4 SDK, of course.

For development builds: Open the SysEx Librarian project and build it. It will build all of the dependent frameworks as necessary. (Make sure you have set Xcode to put its build products in a custom shared directory -- you can set this in the Building tab of its preferences. Otherwise the cross-project build dependencies won't work.)

For installation builds: There is a shell script in Scripts/BuildSysExLibrarian which builds the whole app and takes care of some miscellaneous details. If you just run the script, you should end up with a SysExLibrarianBuild directory in your home directory, with an "InstalledProducts" directory inside containing the built application. If you want the built results to go elsewhere, feel free to change the script.



Contact

Please send questions or comments to: SysExLibrarian@snoize.com