From jOrgan Wiki v1.25.1
Jump to: navigation, search

jOrgan stores information about an organ in so called dispositions. These files contain all of the necessary information to define the inner workings of an organ.

Included in jOrgan are a few example dispositions only. One of the best ways to learn how to use jOrgan to make your own creation is to modify existing dispositions. Once you've gained a basic understanding of how the various elements of a jOrgan disposition work together, the only limitation to building your own creation is your imagination.


The elements in jOrgan are the building blocks for a disposition. Most elements will be placed on a console, but there might be some that are not visible to the organist.

Each type of element has its own set of properties. Common properties of all elements is their name and description:

The name of the element. Used for identification in lists and for text decorations on a console.

You can use a double space to force a line break in the element name when displayed on a console.

Each element can be described in the description view. Each line containing an equal sign (=) serves a special purposes: It defines a binding of a text which is available for the style of the element.

As you can see in the following example you can override the element's name and use special characters too

 This rank definitely needs some more work.
 name = Principal
 pitch = 16
 division = ⊙

See the Wiki page of each element type for on overview of its specialized properties.


References in jOrgan are the connections between various elements. Each reference lets one element (the referrer) influence the referenced element.

See the Wiki page of each element type for on overview of its specialized references.


Messages are jOrgan's connection to the outer world. A message is used to receive or send wikipedia:Midi messages:

  • When a Midi message is received it is matched against all input messages in your disposition, triggering an event on a successful match,
  • on certain events the corresponding output messages in your disposition generate a Midi message.

Each message has a name that describes the event is belongs to. Furthermore it consists of a list of MPL command expressions.

See the Wiki page of each element type for on overview of its specialized messages.