User Guide  for  Hauptwerk
About Hauptwerk
Welcome
What is it?
What is it used for?
Licensing
Installation
Prerequisites
Background
Installing
Upgrading
Backups
Quick start
Stand-alone
MIDI sequencing
VSTi plug-in
Background
Tour of a pipe organ
Using Hauptwerk
The virtual console
Settings screens
Menus
The File menu
Loading sample sets
Combination files
The registration sequencer
Temperaments
Audio routing and multi-channel audio
Activation and reset
Capture mode
Recording audio
Master tuning
The transposer
MIDI input
MIDI output
Re-directable inputs
Component installer
Importing v1 organs
MIDI organ consoles
MIDI sequencing
Organ design tools
Performance tuning
General options
Sample set options
Voicing
Reference
MIDI implementation
Troubleshooting
Creating sample sets

MIDI sequencing


The quick start: MIDI sequencing section covers basic configuration for use with a non-VST compatible MIDI sequencer, using a virtual MIDI cable such as the IAC Driver on an Apple Mac or MIDI Yoke or LoopBe on a Windows PC. The quick start: VSTi plug-in section covers the same material for use with a VST-compatible sequencer, such as Steinberg Cubase.

This section is intended to provide additional reference applicable to both types of sequencer.

Except for the General settings | MIDI input paths screen, where it will have been necessary to change the MIDI input port setting for non-VSTi use, the default MIDI input and output configuration installed with Hauptwerk would not normally need to be changed for use with either type of sequencer, and is intended to be sufficiently comprehensive.

For non-VSTi use, if the MIDI input port was changed to the first virtual MIDI cable as suggested in the quick start section, then all sequencer tracks that you wish to route to Hauptwerk should send their output to that port for simplicity. Thus it is only necessary to change the track's channel and contents to control different aspects of Hauptwerk's behaviour.

Similarly for VSTi use, a track's output needs to be routed to the instance of the Hauptwerk VST plug-in, with the track's channel and contents determining Hauptwerk's actions. Note that only one instance of the Hauptwerk plug-in is allowed to run at any one time.

The following sections describe how to use the default MIDI input configuration installed with Hauptwerk. If you change the configuration via the MIDI input options on the General settings or Organ settings menus (as described in the MIDI input and MIDI output sections), then the following information may no longer apply, and you must instead use the values that you have configured.


Keyboards

For the default configuration, provided that the sample set includes the relevant keyboard, simply set the track's MIDI channel as follows to route to a given virtual organ keyboard, using note-on/off messages to control the virtual keys:
  • Keyboards: div. 1 (Pedal) - channel 1
  • Keyboards: div. 2 (Great) - channel 2
  • Keyboards: div. 3 (Swell) - channel 3
  • Keyboards: div. 4 (Choir) - channel 4
  • Keyboards: div. 5 (Solo) - channel 5
Note that routing MIDI to Hauptwerk in this way enables Hauptwerk's couplers and stops to work as normal. In particular, you will not hear any sound unless a stop is engaged on the relevant division for the keyboard.


Continuous controls (swell pedals, crescendo pedals, etc.)

To route MIDI to a virtual swell or crescendo using the default configuration, provided that it exists within the sample set, set the track's MIDI output channel as follows and use MIDI continuous controller messages within the track with the controller number set as follows:
  • Crescendos: general - channel 7, controller number 2 (breath control)
  • Swells: div. 1 (Pedal) - channel 1, controller number 1 (modulation wheel)
  • Swells: div. 2 (Great) - channel 2, controller number 1 (modulation wheel)
  • Swells: div. 3 (Swell) - channel 3, controller number 1 (modulation wheel)
  • Swells: div. 4 (Choir) - channel 4, controller number 1 (modulation wheel)
  • Swells: div. 5 (Solo) - channel 5, controller number 1 (modulation wheel)
  • Swells: general - channel 7, controller number 1 (modulation wheel)

Virtual pistons

To trigger a sample set's virtual pistons using the default configuration, send a MIDI program change message with the following channels and program numbers:
  • Combination pistons: div. 1 (Pedal) - channel 1, prog. 1-10.
  • Combination pistons: div. 2 (Great) - channel 2, prog. 1-10.
  • Combination pistons: div. 3 (Swell) - channel 3, prog. 1-10.
  • Combination pistons: div. 4 (Choir) - channel 4, prog. 1-10.
  • Combination pistons: div. 5 (Solo) - channel 5, prog. 1-10.

  • Combination pistons: general - channel 7, prog.1-20.
  • General cancel - channel 7, prog. 64.


Virtual stops

Send MIDI note-on/off messages to turn the virtual stop switches on and off using the default configuration, with the following channels and note numbers:
  • Stops: div. 1 (Pedal) - channel 8, notes 36-67.
  • Stops: div. 2 (Great) - channel 9, notes 36-67.
  • Stops: div. 3 (Swell) - channel 10, notes 36-67.
  • Stops: div. 4 (Choir) - channel 11, notes 36-67.
  • Stops: div. 5 (Solo) - channel 12, notes 36-67.

In order to view or adjust which stops are assigned to which note numbers, load the sample set then use the Organ settings | Connect switch MIDI inputs to organ switches screen to select the organ stops in the browse list, and view or change the input switches to which they are assigned.


Virtual couplers

Please look at the General settings | Switch (MIDI) inputs screen for the full list. We will only list the commonly-used couplers here. Send MIDI note-on/off messages to turn the virtual switches on and off using the default configuration, with the following channels and note numbers:
  • Couplers: div. 2 (Great) to div. 1 (Pedal) - channel 8, note 74.
  • Couplers: div. 3 (Swell) to div. 1 (Pedal) - chan. 8, note 79.
  • Couplers: div. 3 (Swell) to div. 1 (Pedal) oct. - chan. 8, note 80.
  • Couplers: div. 4 (Choir) to div. 1 (Pedal) - chan. 8, note 84.
  • Couplers: div. 4 (Choir) to div. 1 (Pedal) oct. - chan. 8, note 85.
  • Couplers: div. 5 (Solo) to div. 1 (Pedal) - chan. 8, note 89.
  • Couplers: div. 5 (Solo) to div. 1 (Pedal) oct. - chan. 8, note 90.

  • Couplers: div. 1 (Pedal) to div. 2 (Great) bass - chan. 9, note 71.
  • Couplers: div. 3 (Swell) to div. 2 (Great) sub-oct. - chan. 9, note 78.
  • Couplers: div. 3 (Swell) to div. 2 (Great) - chan. 9, note 79.
  • Couplers: div. 3 (Swell) to div. 2 (Great) oct. - chan. 9, note 80.
  • Couplers: div. 4 (Choir) to div. 2 (Great) sub-oct. - chan. 9, note 83.
  • Couplers: div. 4 (Choir) to div. 2 (Great) - chan. 9, note 84.
  • Couplers: div. 4 (Choir) to div. 2 (Great) oct. - chan. 9, note 85.
  • Couplers: div. 5 (Solo) to div. 2 (Great) sub-oct. - chan. 9, note 88.
  • Couplers: div. 5 (Solo) to div. 2 (Great) - chan. 9, note 89.
  • Couplers: div. 5 (Solo) to div. 2 (Great) oct. - chan. 9, note 90.

  • Couplers: div. 1 (Pedal) to div. 3 (Swell) bass - chan. 10, note 71.
  • Couplers: div. 3 (Swell) sub-oct. - chan. 10, note 78.
  • Couplers: div. 3 (Swell) unison off - chan. 10, note 79.
  • Couplers: div. 3 (Swell) oct. - chan. 10, note 80.
  • Couplers: div. 4 (Choir) to div. 3 (Swell) sub-oct. - chan. 10, note 83.
  • Couplers: div. 4 (Choir) to div. 3 (Swell) - chan. 10, note 84.
  • Couplers: div. 4 (Choir) to div. 3 (Swell) oct. - chan. 10, note 85.
  • Couplers: div. 5 (Solo) to div. 3 (Swell) sub-oct. - chan. 10, note 88.
  • Couplers: div. 5 (Solo) to div. 3 (Swell) - chan. 10, note 89.
  • Couplers: div. 5 (Solo) to div. 3 (Swell) oct. - chan. 10, note 90.

  • Couplers: div. 1 (Pedal) to div. 4 (Choir) bass - chan. 11, note 71.
  • Couplers: div. 3 (Swell) to div. 4 (Choir) sub-oct. - chan. 11, note 78.
  • Couplers: div. 3 (Swell) to div. 4 (Choir) - chan. 11, note 79.
  • Couplers: div. 3 (Swell) to div. 4 (Choir) oct. - chan. 11, note 80.
  • Couplers: div. 4 (Choir) sub-oct. - chan. 11, note 83.
  • Couplers: div. 4 (Choir) unison off - chan. 11, note 84.
  • Couplers: div. 4 (Choir) oct. - chan. 11, note 85.
  • Couplers: div. 5 (Solo) to div. 4 (Choir) sub-oct. - chan. 11, note 88.
  • Couplers: div. 5 (Solo) to div. 4 (Choir) - chan. 11, note 89.
  • Couplers: div. 5 (Solo) to div. 4 (Choir) oct. - chan. 11, note 90.

  • Couplers: div. 5 (Solo) sub-oct. - chan. 12, note 88.
  • Couplers: div. 5 (Solo) unison off - chan. 12, note 89.
  • Couplers: div. 5 (Solo) oct. - chan. 12, note 90.


Virtual tremulants

Send MIDI note-on/off messages to turn the virtual switches on and off using the default configuration, with the following channels and note numbers:
  • Tremulants: div. 1 (Pedal) main - chan. 8, note 93.
  • Tremulants: div. 1 (Pedal) Tibia - chan. 8, note 94.
  • Tremulants: div. 1 (Pedal) solo 1 - chan. 8, note 95.
  • Tremulants: div. 1 (Pedal) solo 2 - chan. 8, note 96.

  • Tremulants: div. 2 (Great) main - chan. 9, note 93.
  • Tremulants: div. 2 (Great) Tibia - chan. 9, note 94.
  • Tremulants: div. 2 (Great) solo 1 - chan. 9, note 95.
  • Tremulants: div. 2 (Great) solo 2 - chan. 9, note 96.

  • Tremulants: div. 3 (Swell) main - chan. 10, note 93.
  • Tremulants: div. 3 (Swell) Tibia - chan. 10, note 94.
  • Tremulants: div. 3 (Swell) solo 1 - chan. 10, note 95.
  • Tremulants: div. 3 (Swell) solo 2 - chan. 10, note 96.

  • Tremulants: div. 4 (Choir) main - chan. 11, note 93.
  • Tremulants: div. 4 (Choir) Tibia - chan. 11, note 94.
  • Tremulants: div. 4 (Choir) solo 1 - chan. 11, note 95.
  • Tremulants: div. 4 (Choir) solo 2 - chan. 11, note 96.

  • Tremulants: div. 5 (Solo) main - chan. 12, note 93.
  • Tremulants: div. 5 (Solo) Tibia - chan. 12, note 94.
  • Tremulants: div. 5 (Solo) solo 1 - chan. 12, note 95.
  • Tremulants: div. 5 (Solo) solo 2 - chan. 12, note 96.

Menu functions

To trigger Hauptwerk's menu functions from a sequencer track using the default configuration, send MIDI program change messages on MIDI channel 7 with the following program numbers:
  • Organ | Load/assign stand-by organ 1 - prog. 21.
  • Organ | Load/assign stand-by organ 2 - prog. 22.
  • Organ | Load/assign stand-by organ 3 - prog. 23.
  • Organ | Load/assign stand-by organ 4 - prog. 24.
  • Organ | Load/assign stand-by organ 5 - prog. 25.
  • Organ | Load/assign stand-by organ 6 - prog. 26.
  • Organ | Load/assign stand-by organ 7 - prog. 27.
  • Organ | Load/assign stand-by organ 8 - prog. 28.
  • Combinations | Save combinations with an automatic filename - prog. 37.
  • Combinations | Load/assign stand-by comb. file 1 - prog. 29.
  • Combinations | Load/assign stand-by comb. file 2 - prog. 30.
  • Combinations | Load/assign stand-by comb. file 3 - prog. 31.
  • Combinations | Load/assign stand-by comb. file 4 - prog. 32.
  • Combinations | Load/assign stand-by comb. file 5 - prog. 33.
  • Combinations | Load/assign stand-by comb. file 6 - prog. 34.
  • Combinations | Load/assign stand-by comb. file 7 - prog. 35.
  • Combinations | Load/assign stand-by comb. file 8 - prog. 36.
  • Combinations | Advance registration sequencer frame - prog. 38.
  • Combinations | Decrement registration sequencer frame - prog. 39.
  • Combinations | Re-activate current registration sequencer frame - prog. 40.
  • Combinations | Go to start of registration sequencer bank 1 - prog. 41.
  • Combinations | Go to start of registration sequencer bank 2 - prog. 42.
  • Combinations | Go to start of registration sequencer bank 3 - prog. 43.
  • Combinations | Go to start of registration sequencer bank 4 - prog. 44.
  • Combinations | Go to start of registration sequencer bank 5 - prog. 45.
  • Combinations | Go to start of registration sequencer bank 6 - prog. 46.
  • Combinations | Go to start of registration sequencer bank 7 - prog. 47.
  • Combinations | Go to start of registration sequencer bank 8 - prog. 48.
  • Temperament | Equal temperament - prog. 53.
  • Temperament | Original organ tuning - prog. 54.
  • Temperament | Load/assign stand-by temperament 1 - prog. 49.
  • Temperament | Load/assign stand-by temperament 2 - prog. 50.
  • Temperament | Load/assign stand-by temperament 3 - prog. 51.
  • Temperament | Load/assign stand-by temperament 4 - prog. 52.
  • Functions | Reset - prog. 55.
  • Functions | Clear transposer - prog. 63.
  • Functions | Increment transposer by one semitone - prog. 61.
  • Functions | Decrement transposer by one semitone - prog. 62.
  • Functions | Clear master tuning - prog. 60.
  • Functions | Increment master tuning by one percent of a semitone 58.
  • Functions | Decrement master tuning by one percent of a semitone - prog. 59.
Note that there are more menu functions which can be controlled by MIDI (see the General settings | Menu functions activated by switch (MIDI) inputs screen for the full list); only those configured by default are listed above. Many menu functions may take a few seconds to complete, so you should allow for this when playing, or triggering them from a sequencer track.

For example, to specify that a sequencer track should use the original organ tuning, you would simply need to include a MIDI program change message for program number 54 on channel 7, sending to the first virtual MIDI cable port.

Note that, by default, the capture mode menu functions are not assigned to use MIDI program change messages; see below.


Capture mode

With the default configuration, Hauptwerk's capture mode (setter) is controlled by MIDI note-on/off messages:
  • Capture mode: note-on/off, channel 7, note 56.
Visit Crumhorn Labs on the Internet
© Crumhorn Labs Ltd 2001-2008

Hauptwerk, Hauptwerk virtual pipe organ, Crumhorn Labs and the Crumhorn Labs and Hauptwerk logos are trademarks of Crumhorn Labs Ltd.