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

Quick-start: MIDI sequencing configuration


Follow these instructions if you will be playing Hauptwerk from a software MIDI sequencer and you are using an Apple Mac, or you are using a Windows PC but your sequencer does not accept VST instrument plug-ins.

Make sure that you have followed all of the installation steps in the installation section. In particular, make sure that you enabled the IAC Driver if you are using an Apple Mac, or installed MIDI Yoke (32-bit Hauptwerk only) or LoopBe (32-bit or 64-bit Hauptwerk) if you are using a Windows PC. Make sure that your MIDI interface and audio/sound interface are properly connected to the computer computer and powered up, and that your USB dongle licence key is attached to a USB port on the computer if you have purchased a licence for Hauptwerk.

Connect the audio output from your audio/sound interface to some form of external amplification, such as a hi-fi system or headphones.

Now run the MIDI sequencer Hauptwerk configuration by double-clicking on the Hauptwerk (MIDI sequencing) icon on your desktop. If you are asked whether you would like to optimise Hauptwerk for maximum realism or performance, respond according to your preference.

The main Hauptwerk window should appear (appearances will vary a little depending on whether you are using an on Apple Mac computer or a Windows PC):

Main Hauptwerk window


Go to General settings | Audio outputs from the menu. For the Audio output device setting, select the audio/sound interface that you have connected to the amplifier.

On Windows PCs: selecting the entry for the correct native (manufacturer-supplied) driver for your audio interface is crucial to getting good performance with Hauptwerk. A native ASIO driver is usually best if available, otherwise choose a native DirectSound driver. The Creative series of sound cards are exceptions, since Creative's ASIO drivers are very restrictive. For Creative sound cards (only), please select Creative's DirectSound driver instead of their ASIO driver. Always avoid third-party or emulated drivers.

Next verify or adjust the left and right device channel settings, ensuring that the audio output connections are selected that you have connected to your amplifier.

For example:

Audio outputs screen


Click OK.

From the menu now choose General settings | MIDI input paths. Select the first path in the left-hand pane ('General and util pistons'). In the right-hand pane, ensure that the MIDI input port is set to the first virtual MIDI cable. On an Apple Mac the first virtual MIDI cable will be called '[IAC Driver] Bus 1', whereas on a Windows PC it will be 'MIDI Yoke NT: 1'. Repeat for each of the paths in the left-hand pane, setting them all to use the first virtual MIDI cable:

MIDI input paths screen


Click OK.

If you are using the Advanced Edition of Hauptwerk, or an evaluation copy, from the menu choose General settings | MIDI output paths. With the first entry selected in the left-hand browse list, for now ensure that its MIDI output port is set to a 'real' MIDI port that has no external MIDI hardware attached to it, and not to a software or hardware synthesizer (otherwise the synthesizer may be triggered when you change registration or play Hauptwerk). Repeat for each entry in the left-hand browse list:

MIDI output paths


Click OK.

From the menu, choose Organ | Load organ:

The Organ menu


For the majority of audio interfaces, click on the StAnnesMoseley entry, then click OK. If, however, you are using a Creative Audigy interface in ASIO mode (not recommended) on a Windows PC, or another interface whose driver has a locked sample rate of 48 kHz, instead click on the StAnnesMoseley-ForLocked48kHzDrivers entry and click OK. After a brief pause a screen entitled Rank Audio Output Routing should appear.

If you have at least 1 GB of memory installed in the computer, simply click OK. If not, assuming you have 512 MB of installed memory (the minimum required), select each Swell and Pedal rank in turn from the left-hand list, and change its Audio enabled? setting to 'No', repeat for the Noise 'ranks' (so that only the Great ranks remain enabled), then click OK:

Rank audio output routing screen


The sample set should now load, which may take a few minutes, depending on the speed of your computer. The first time that a sample set is loaded, analysis and processing of the sample set data are performed, the results of which are saved to a special 'sample set data cache', so that each subsequent load is many times faster. However, if you change certain audio routing settings or general settings, Hauptwerk might need to perform such processing again to reflect the changes. This happens automatically when required. Options that cause regeneration of the sample set caches are clearly identified on the settings screens, and there are very few. Changing per-rank options via Organ | Load organ, adjusting rank audio output routing also causes the sample set data cache to be regenerated for the selected sample set.

As soon as the sample set has finished loading, Hauptwerk will automatically attempt to start the audio and MIDI drivers/interfaces. If any errors occur relating to unsupported audio formats or sample rates, change the audio device selected on the General settings | Audio outputs screen, and adjust the audio channel configuration as necessary.

Once the audio and MIDI systems are activated successfully, the St. Anne's organ console should appear:

Hauptwerk console screen


Click on the 'OPEN DIAPASON LARGE 8' stop on the right-hand side of the console to engage it.

Now click on a key on the lower of the two virtual manuals (keyboards), and hold it down. You should be able to hear the corresponding pipe sounding. If not, check the audio connections, that the amplifier is turned up, and, if necessary, check the settings on the General settings | Audio output screen.

If the sound is breaking up or crackling whenever any pipe sounds, then first of all check that the audio connections and wiring are good. If so, with the sample set still loaded, go to General settings | Audio output. Try larger audio buffer size settings. The buffer size setting determines the delay between pressing a key and hearing the sound, termed the latency. Buffer sizes in the region of 1024 samples (the default) usually work well, but you can certainly use smaller buffer sizes to give a faster reponse (lower latency) if your hardware supports it, usually at the expense of a little polyphony. Most professional audio interfaces can manage a buffer size of 512 samples without a significant reduction in polyphony.

On Windows PCs: some DirectSound drivers work well with certain specific small buffer sizes but not others. In general, manufacturer-supplied ASIO drivers, which are almost always available on professional audio interfaces, are to be preferred. Note also that some ASIO drivers only allow the buffer size to be adjusted via the manufacturer-supplied ASIO control panel. If Hauptwerk's buffer size setting is having no effect, click on the Show device control panel button and try adjusting the buffer size there.

Note that the driver and the buffer size setting determine the latency, rather than Hauptwerk itself.

Now run your MIDI sequencer program. Set the output from a track to the first virtual MIDI cable ('[IAC Driver] Bus 1' on an Apple Mac or 'MIDI Yoke NT: 1' or 'LoopBe Internal MIDI' on a Windows PC) and the MIDI channel to 2 (which is the default channel for the 'Keyboards: div 2 (Great)' input path). Ensuring that a non-disabled stop is still engaged on the Great division (such as the Great Open Diapason Large 8), record and play back some notes on the sequencer track. You should see Hauptwerk's virtual keys respond and hear the Hauptwerk virtual pipes sound. If not, check that the same virtual MIDI cable is selected both in Hauptwerk and the sequencer, and that the channels match in both cases. You may possibly need to close Hauptwerk and load the sequencer program before loading the sample set in Hauptwerk.

Once you have one track controlling Hauptwerk's virtual Great keyboard, you can create others to control other virtual manuals. In each case, you simply need to select the first virtual MIDI cable, and choose the MIDI channel to match the channel for Hauptwerk's corresponding MIDI input paths. With the initial default configuration (assuming you haven't re-assigned any MIDI channels with the MIDI input paths screen), the MIDI channels are:
  • Keyboards: div 1 (Pedals) - 1
  • Keyboards: div 2 (Great) - 2
  • Keyboards: div 3 (Swell) - 3
  • Keyboards: div 4 (Choir) - 4
  • Keyboards: div 5 (Solo) - 5
Hauptwerk's swell and crescendo pedals can be controlled by inserting MIDI continuous controller messages in a track in the MIDI sequencer, with the track's output set to the first virtual MIDI cable, and choosing the MIDI channel and continuous controller to match those of the path and continuous controller selected for Hauptwerk's General settings | Continuous control MIDI inputs screen. With the initial default configuration (assuming you haven't re-assigned any MIDI channels with the MIDI input paths screen, or continuous controller numbers with the Continuous control MIDI inputs), the channels and controllers for Hauptwerk's swell and crescendo pedals are 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)
For further information, including the MIDI messages you should insert into sequencer tracks to control virtual draw-knobs, pistons and other virtual organ controls, please see the using Hauptwerk: MIDI sequencing section.

Finally, please now make a backup of your Hauptwerk settings and data following the step-by-step 'How to make a backup' instructions in the backups section of the guide. Doing so should allow you to get your current settings back in case your computer ever needs to be re-installed in the future.


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.