Build Status Code Climate


MIDI Looper designed for Live performances


Install it:

$ gem install banjo


Mac OS X

You need to create virtual MIDI IAC inputs. You can learn how to do so by watching this video.

Each one of these inputs will work as a Channel for Banjo.

To make sure you have IAC inputs set up properly you can run the following command:

$ unimidi list

0) Apple Inc. IAC Driver
1) Apple Inc. IAC Driver

The unimidi list command will show you a list of the available IAC drivers that can be used with Banjo.


Promise to come back to write a proper guide, for now take a look at the included sample.

After you create the IAC driver open Garage Band.

Go to the sample/basic folder and run:

$ ruby song.rb

You should be able to listen some of the tones created by Banjo.

Edit channels/main_channel.rb on the sample/basic folder while the Banjo reactor is running and you will notice the changes in realtime.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request