HauptwerkTM Version 3.00 Release Notice

Release notice version: 1.02

November 2007

© Crumhorn Labs Ltd 2001-2007


The most current source of information about Hauptwerk, known bugs etc., is the Crumhorn Labs website, which should also be consulted when required.


Overview

Hauptwerk version 3 supersedes versions 2 and 1, and is owned and developed by Crumhorn Labs Ltd., directed by Martin Dyde, the original author of version 1. Version 2 included many, many major new features above version 1, aimed at providing the most realistic and best-performing model of an organ possible on current computer hardware, and to provide a solid foundation for future development for years to come. Version 3 significantly extends the functionality provided in version 2, and will continue to do so in forthcoming releases.

Version 3.00 is a major release, containing various major functional and performance enhancements, and many other minor enhancements and bug fixes. Some of the highlights above version 2 include native multi-monitor/multi-touchscreen support, additional user voicing adjustments, improved memory handling, better performance from given hardware, a much more robust audio recording system, additional 14 and 20-bit audio options (saving memory over the existing 16 and 24-bit), redesigned bass/melody couplers and a new/extended easy but very powerful organ definition format suitable for amateur/hobbyist sample set producers and theatre organs. Another important focus has been to provide full native support for the new Windows Vista operating systems (32 and 64-bit versions) and for Apple Mac OS X Leopard (10.5). Please note that Hauptwerk currently runs as a 32-bit application on Mac OS X, but we hope to produce 64-bit Hauptwerk for Mac OS X 10.5 in a future release as soon as possible.

As well as Windows PCs, since version 2.20 Hauptwerk is also supported on Mac OS X (10.4 and above) on all Intel-based Macs and PowerPC G4/G5-based Macs. Currently there is no plug-in (Audio Unit) version of Hauptwerk on the Mac platform, but that is planned for a future release. The PC and Mac versions of the Hauptwerk software are available on separate installation media, due to their size, and can be ordered or downloaded from the Crumhorn Labs on-line shop. However, any Hauptwerk version 3 licence (and USB licence key dongle) is valid on any computer, Mac or PC; you are free to change your computer hardware as often as you like, with no registration, licence updates or cross-grade charges required for such changes.

Also planned for future version 3 releases soon: 64-bit Hauptwerk for Mac OS X 10.5, much quicker and easier initial MIDI configuration, plus plenty of other performance, usability and functional enhancements as always. We will also be aiming to provide native high-performance convolution reverb within Hauptwerk.


Compatibility, Support and Licensing Policies

All existing Hauptwerk sample sets should be compatible with this version of Hauptwerk. Version 3 is fully and seamlessly backwardly-compatible with version 2, hence all settings are preserved and all sample sets that worked in version 2 remain natively fully compatible with version 3. Sample sets in Hauptwerk version 1 format can be imported and used in this version, as they could in version 2.

Version 3 can perform better in every way than version 1, with much higher audio quality and more realism, and many more features, and version 1 is thus now considered obsolete and is no longer available or supported. If you have a licence for version 1 you must upgrade to version 3 in order to continue receiving support from us. A very affordable upgrade is available from version 1 to the lower-cost version 3 Basic Edition (previously known as the Studio Edition).

Version 3 should also out-perform version 2 on any given supported computer hardware and has significant additional functionality above version 2. We will continue to support version 2 for a maximum period of 12 months from the date you purchased a licence for it (either a new licence or an upgrade). After that you must upgrade to the current version in order to continue receiving support from us. There will be no more version 2 releases, and we reserve the right not to assist with issues that would be resolved by upgrading to the current version. In other cases we will attempt to provide reasonable assistance and, if necessary, work-arounds to supported customers.

Reasonably-priced upgrades to version 3 are available from Hauptwerk version 2 editions.

It is our policy to release new functionality in regular medium-sized enhancement releases, typically very approximately every 6 months, rather than accumulating many enhancements for very large releases every few years. Versions 2.10, 2.20 and 3.00 were medium-sized enhancement releases in line with this policy. We believe this benefits customers because they receive new functionality much earlier. However, this needs to be balanced with our need to continue financing ongoing support and development for existing customers.

We do not charge an ongoing subscription for support and continued upgrades since we feel it would be logistically difficult and expensive to administer, confusing to end-users, and might be considered unfair in cases where no enhancements were released in a given subscriptions period that were of interest to a given user. Hence from version 3 onwards we have instead adopted a policy of charging a relatively modest upgrade cost for an enhancement release approximately every 18 months. Thus some enhancement releases will be free to appropriately-licensed users, as versions 2.10 and 2.20 were to users with a licence for version 2, whilst others are chargeable, as version 3.00 is. Chargeable enhancement releases are not necessarily any larger than their free counterparts; an increment of major version simply means that some upgrade cost is involved.

It is also our intention that all future Hauptwerk versions remain fully and seamlessly backwardly-compatible with version 2.00 and above; Hauptwerk and its installer will automatically and transparently update your settings to each new version, and all existing sample sets will remain fully compatible with it, as with this version. Thus an increment of major version number does not involve any break in compatibility.

From version 3 onwards the previous Concert Edition has been renamed to the Advanced Edition and the Studio Edition to the Basic Edition. There is no loss of functionality from the Basic (previously Studio) Edition; these are simply changes of name to clarify that the Basic Edition has a subset of the functionality of the full Advanced (previously Concert) Edition, rather than being aimed at any specific type of users.


Media, Downloads, Installation and Upgrading

We very strongly recommend that you read the User Guide for Hauptwerk, which includes important prerequisites and installation instructions, and is included on the Hauptwerk CD and on-line on the Crumhorn Labs website before attempting to install or upgrade Hauptwerk. Please ensure that you follow the instructions in the relevant installation section.

In particular, please ensure that you have at least 512 MB of memory, and at least 4 GB of free disk space, otherwise Hauptwerk's installer may not function correctly. On Windows platforms, please also ensure that you have Windows XP Service Pack 2 or Windows Vista, Microsoft Direct-X version 9.0 or above installed. On Mac platforms you must have OS X 10.4.10 or later installed. Please also make sure that you have the latest drivers installed for your audio and MIDI interface(s).

Since version 2.10 a small hardware USB dongle is used to license Hauptwerk and some third-party sample sets for it.

Hauptwerk licences, licence upgrades and evaluation or update CDs or downloads can be ordered from the Crumhorn Labs on-line shop or from your re-seller. The software itself is identical in all cases, and contains the full Hauptwerk software and installer at the latest version. The installer will install Hauptwerk on the computer if Hauptwerk version 2.00 or later is not already installed on it, or upgrade your existing Hauptwerk installation to the latest version if version 2.00 or later is already installed. No settings will be lost when upgrading and no sample set sets need to be re-installed.

You can obtain the current Hauptwerk software either as a free download or on CD at a minimal cost. Both are available from our on-line shop. The relevant items are named 'Hauptwerk v3 trial/update download' and 'Hauptwerk v3 trial/update CD'. Whether the software functions as licensed software or as an evaluation is determined by the presence or absence of the USB licence key dongle, and whether it contains a valid licence for the version of the software you have installed.

If you do not have a licence for Hauptwerk version 3 the software will function as an evaluation copy. If you had an evaluation copy of version 2 installed then the installer will upgrade it to an evaluation copy of version 3.

If you do not have a licence for Hauptwerk version 2 or 3 and you buy a licence for version 3 then you will be sent the necessary USB licence key dongle as well as a copy of the software CD containing the latest version of Hauptwerk. You just need to make sure that you have the latest version of Hauptwerk installed then attach the licence key dongle to the computer.

If you already have a licence for Hauptwerk version 2 then you need to purchase an upgrade to version 3 in order to be able to use this version as licensed software. Once you have purchased an upgrade we, or your re-seller, will contact you to arrange to update your existing USB licence key dongle remotely to enable version 3 on it. This is a simple process that requires exchanging two small files by email, and full instructions will be sent to you following your order. If your Hauptwerk computer does not have an Internet connection you can transfer the files via a writeable CD, floppy disk, USB memory stick or similar.

IMPORTANT: If your licence is for version 2 and you do not update your licence for the current version before installing, Hauptwerk will revert to running in evaluation mode but allow you to apply the licence upgrade at any time to restore full licensed functionality. A computer can only have one version of Hauptwerk installed on it at any one time. Once a new version has been installed it is not possible to revert to a previous version without un-installing Hauptwerk completely (selecting the option to remove all files) then re-installing the older version, which would wipe any existing settings. Hence there is no easy way to revert to a licensed installation once version 3 has been installed other than by purchasing a licence upgrade.

If you have a licence for the version 3 Basic Edition of Hauptwerk and wish to evaluate the additional features of the Advanced Edition with a view to upgrading your licence, simply disconnect your licence key dongle temporarily (although never connect or disconnect it whilst Hauptwerk is actually running). Hauptwerk will then start in evaluation mode, allowing all of the features of the Advanced Edition to be evaluated (except for the wind supply model). No settings will be lost in the process, and you simply need to reconnect your licence key dongle to revert it to the licensed Basic Edition.


Testing

This release has primarily been developed and tested on the following systems: Additional beta testing has been carried out for versions 2.00, 2.10, 2.20 and 3.00 by third parties on many other systems, old and new.


Changes to Hauptwerk

Please note that enhancement and bug numbers refer to the corresponding pages on the website. All Hauptwerk releases since version 2.00 are cumulative, thus each includes all changes from previous Hauptwerk versions.


Changes in version 3.00

Version 3.00 includes full native support for Windows Vista (32 and 64-bit), full native support for Mac OS X Leopard (10.5), various major functional and performance enhancements and many other minor enhancements and bug fixes. The following are included:


ENHANCEMENT HW-000191: Voicing: stereo balance now adjustable for each pipe (Advanced Edition only).

The Advanced Edition of Hauptwerk has per-pipe voicing facilities to allow the sound of a sample set to be adjusted to suit the acoustics of the listening environment and for aesthetic reasons. When a rank is routed to one or more stereo output pairs in Hauptwerk (pipes can be distributed amongst groups of mono or stereo outputs using Hauptwerk's multi-channel audio output facilities) a new adjustment is available on the voicing screen, which allows each pipe's stereo balance (left to right amplitude ratio) to be adjusted between the two audio channels to which it is routed. This is possible when stereo samples are used, as well as (panned) mono. A new setting is also available to sample set producers in the organ definition file format (Pipe_SoundEngin01_Layer table) to specify the default for this stereo balance setting.


ENHANCEMENT HW-000460: Much more advanced disk-streaming mechanism used for built-in audio output recording facility gives extremely high resilience to audio glitches.

Some computers were more prone to producing occasional slight audio glitches whilst using Hauptwerk's built-in recording system (not in the recorded audio) with Hauptwerk versions 1.00 to 2.21. A much more advanced disk-streaming mechanism is now used for the built-in recording system that is able to avoid the problem entirely, even with slower hard-disks. If you still hear any audio glitches in Hauptwerk's output whilst it is recording but not at other times, or find any glitches in the resulting audio file, try increasing the new 'Audio output recording buffer size' setting on the 'General settings | General options' screen. The setting determines the maximum amount of time Hauptwerk allows your hard-disk to write a chunk of streamed audio to disk before an audio glitch will be heard or recorded. The default setting should be fine for most modern hard-disks but if you have an old or slow disk or are recording a lot of audio outputs simultaneously then it might be necessary to increase this setting. Larger values use a little more memory.


ENHANCEMENT HW-000483: All Hauptwerk data now locked into physical memory only, avoiding the need to disable virtual memory under Windows (Windows only).

If sample data is cached ('paged') to the hard-disk, then the operating system will not usually be able to retrieve it sufficiently rapidly and audio glitches will result. As was previously the case under OS X, Hauptwerk is now also able to guarantee that no sample memory will be cached to disk under Windows, provided that you are logged onto your computer with an operating system user account that has administrator privileges, such as the default Windows account. You will thus receive an error if you try to load a sample set that will not fit into your computer's available physical memory. If you experience problems with latency or audio breaking up, please make sure that you are logged onto your computer with a computer account that has administrator privileges when running Hauptwerk, and also make sure that you have sufficient free memory for the sample set you are loading.

Hence on Windows PCs, in this version of Hauptwerk, unlike version 2 and earlier, it is no longer necessary or advisable to disable Windows virtual memory ('page file'). It is best to keep virtual memory enabled so that other applications can make use of it when required without risking the stability of PC. Note also that Hauptwerk's component installer uses a third-party utility to extract sample sets and might not be able to install very large sample sets if virtual memory is disabled and there is insufficient physical memory, or if disk space is running very low.

On Windows XP use 'Start | Settings | Control Panel | System', then click on the 'Performance | Settings' button on the Advanced tab. Select 'Adjust for best performance', then click the 'Advanced' tab. Leave 'Processor scheduling' and 'Memory usage' both set to favour programs and ensure that 'Virtual memory' shows a total paging file size of at least several GB, otherwise click 'Change' and select 'System managed size' for the hard-disk you want Windows to use for its virtual memory, then click 'Set'. Finally click 'OK' on all of the windows and re-boot the computer if you changed any settings.

Please note, a new option 'Don't abort loading if can't lock data into memory?' has been added to the 'General options | General settings' screen, which disables memory locking and gives Hauptwerk version 2 behaviour for compatibility for (very rare) cases in which another Windows application reserves most of the computer's memory, preventing Hauptwerk being able to lock memory. It is strongly recommended that this option should not be selected in any other circumstances, and can only safely be used if Windows virtual memory is disabled.


ENHANCEMENT HW-000497: New per-rank options for 20-bit and 14-bit sample memory resolutions, giving large memory savings over 24-bit and 16-bit.

The 'Organ | Load organ, adjusting rank audio output routing' screen (also shown when you load an organ for the first time) has a setting for the resolution in which each rank will be loaded into memory, as well as an option to enable loss-less memory compression. Previously only 16-bit and 24-bit options were available. 14-bit and 20-bit options have now been added. These two new resolutions only offer any advantages if memory compression is enabled, since they compress much more than 16-bit and 24-bit respectively, thus saving a large amount of memory. For example one relatively dry third-party sample set (drier sample sets typically compress less) compressed by 47.98 percent when loaded in 14-bit, compared to 27.28 percent when loaded in 16-bit, and by 49.68 percent in 20-bit, compared to 30.51 percent in 24-bit. The 20-bit option is especially useful since it gives most of the audible benefits of a 24-bit resolution, but without using much more memory than loading in 16-bit without compression. Note that you might notice more hiss with the 14-bit option, due to the limitations of the lower resolution. However, it might, for example, be a useful choice for some ranks for which only a few pipes will sound at once, such as softer Pedal ranks.


ENHANCEMENT HW-000545: Microsoft Windows Vista (32 and 64-bit versions) fully supported (Windows only).

We now fully support Hauptwerk on the following editions of Windows Vista (both 32-bit and 64-bit): Home Basic Edition, Home Premium Edition, Ultimate Edition, Business Edition.

As with 32-bit Windows XP, all 32-bit versions of Vista have a 2 GB limit per-application memory limit, although that can be increased to approximately 2.7 GB using Vista's BCDEdit utility to increase the Windows IncreaseUserVA parameter (similar to the /3GB and /Userva Windows boot.ini switches needed for 32-bit XP). This Microsoft MSDN page also describes parameters for increasing the 2 GB per-application memory limit on XP and Vista. Any such modifications are attempted at your own risk. 64-bit versions of Vista have no such per-application limit, and can all use 8 GB of memory or more, depending on the edition. Please note that only the Business and Ultimate editions of Vista can use two physical CPUs, but all editions can make use of a single multi-core CPU.

Please check with your audio/MIDI interfaces' manufacturers for driver support before installing Vista. Please also consult the Crumhorn Labs website for any updated recommendations.


ENHANCEMENT HW-000569: Performance: new optimisations typically giving approx. 15-30 percent higher polyphony on given computer hardware (Intel Macs and PCs, 8-15 percent on G4/G5 Macs).

Various additional performance optimisations have proved to be possible in Hauptwerk's audio engine, giving significant gains in the polyphony that it is able to achieve on given computer hardware. Hence you might wish to re-test the polyphony that your computer is able to achieve as described in the 'Performance tuning' section in the user guide, and adjust your polyphony limit setting accordingly. The maximum polyphony remains at 1024 in the smaller Basic Edition (previously known as the Studio Edition). Please note that a very, very small increase in memory usage by a given sample set has been necessary to be able to achieve these gains in polyphony, typically less than 0.1 percent (for example an increase of about 3 MB was measured for a 1715 MB sample set). This results from the way that memory needs to be laid out for significant additional optimisations to the way that Hauptwerk uses the processor's level 2 cache. Since such a significant increase in polyphony results from such an extremely small increase in memory usage, and also since several major new per-rank memory-saving options are now available in Hauptwerk (such as 14-bit sample memory support and options not to load multiple attack or release samples), we feel this is a very worthwhile trade-off.


ENHANCEMENT HW-000571: Voicing: additional per-pipe parametric lo/hi EQ (Advanced Edition only).

A new set of adjustments are available on the per-pipe voicing screen: 'Lo/Hi EQ: transition frequency (kHz)', 'Lo/Hi EQ: transition width (pct of trans freq)' and 'Lo/Hi EQ: high frequency boost (dB)'. These adjustments allow you to apply a simple low-pass or high-pass parametric EQ (filter) to the pipe, adjusting its balance between bass and treble. The transition frequency specifies the centre-point between the bass and treble bands. The transition width determines the steepness of the frequency response curve in the transition region between the bass and treble, and is specified as a percentage of the transition frequency. Generally it is best to avoid very low values for the transition width, since they will give a very steep frequency response and higher 'filter ripple' (an effect where the frequencies either side of the transition are boosted or attenuated excessively in a narrow band, compared to the rest of the frequency response). Equivalent new parameters exist for sample set producers in the organ definition format (Pipe_SoundEngin01_Layer table), and the default values for the user voicing EQ parameters are taken from those. Any adjustments to the user voicing EQ parameters override those specified by the organ's creator. Note that if the EQ's gain is set to any value other than 0 then approximately 30 percent additional processing overhead is incurred for the pipe, reducing the overall polyphony that can be achieved accordingly. Hauptwerk's polyphony management system automatically takes this into account at the pipe level, as with other real-time filters.


ENHANCEMENT HW-000609: Full native support for multiple monitors / multiple touch-screens (Advanced Edition only).

The virtual console display has multiple tabs. If you have the Advanced Edition of Hauptwerk you can now open up to four tabs at once in separate windows using the 'Organ | Show another console window' menu function. This is most useful if your computer has two or more touch-screen monitors attached to it. For example, you could display one window (display tab) on a monitor to the left of your MIDI keyboard(s) and another to the right to give a traditional organ console layout with some stops on either side of your MIDI keyboard(s) when using sample sets that have their virtual console tabs laid out in that way, as the St. Anne's, Moseley organ sample set now does (see ENHANCEMENT HW-000641).


ENHANCEMENT HW-000668: CODM: Enormously extended to provide new organ definition format with sufficient flexibility for amateur/hobbyist sample set producers, digital organ installations and for theatre organs, a fully-customisable graphical console, plus lots more.

The Custom Organ Design Module (CODM) was previously intended to provide a very simple and easy-to-use organ definition format to allow end-users to create basic organ specifications that could be loaded into Hauptwerk to take good advantage of its models using ranks of samples from existing sample sets. The virtual console was generated entirely automatically to minimise the amount of settings that a user needed to specify. Hauptwerk's full native organ definition format existed in parallel, providing all possible flexibility, but at the cost of complexity.

However, feedback from many users has been that an organ definition format providing a level of flexibility and complexity between the two previous formats would be desirable, with sufficient flexibility for amateur/hobbyist sample set producers to create fully functional native Hauptwerk sample sets suitable for public release, but retaining a relatively small and simple file format that was easy to learn and quick to use without the need for third-party databases or other tools.

The CODM organ definition format has been enormously extended to provide for those needs. The new extended format is loaded in the CODM as before (using the 'Design tools | Load custom organ' menu function), compiling automatically to a full native organ definition file, and uses a simple text/XML file format to define the organ as before. The extended format is also fully backwardly-compatible with the previous format (*), thus all new parameters are optional or have defaults.

Here are some of the highlights of the new extensions:

For full documentation for these new extensions to the format please see the updated Custom Organ Design Module User's Guide included with this release. Parameters which are new or extended for this release are identified in that guide.

To get an idea of what's possible using the new CODM, try loading some of the example files by selecting 'Design tools | Load custom organ' on the menu in the new version of Hauptwerk.

Please note that the CODM organ definition format still uses a text/XML file; there is not yet a graphical interface for the organ design process itself. Although it remains just as quick and simple to create simple CODM organs as in previous versions, these new extensions allow quite complex and sophisticated organ definitions to be created. The design goal has been to keep the format as small and simple as possible, but inevitably there is more to familiarise yourself with, and a certain amount of additional complexity if you wish to take advantage of these new features. Hence we would generally advise novice computer users to start with simple CODM organs and examples first.

Important note: because of the sophistication now possible, and because of the 'DIY' nature of creating or editing organs to taste, it needs to be emphasized that we are sorry that we cannot provide personal tuition, or assistance in creating/editing organ definitions, to end-users. The Custom Organ Design Module User's Guide and an extensive set of examples are provided to help. We will usually only be able to provide a small amount of support beyond that. However, you can of course exchange help and advice with other users via our website forum.

[(*) There is one fairly unlikely case in which a manual change might be required to a previous custom custom definition file: only values in the range 1-1024 are now allowed for the Rank.RankID parameter, in order to be able to guarantee that settings and voicing are preserved if ranks are added or removed.]


ENHANCEMENT HW-000681: Apple Mac OS X Leopard (10.5) fully supported (Mac OS X only).

We now fully support Hauptwerk on Mac OS X Leopard (10.5) on both Intel and PowerPC (G4/G5) Macs. OS X 10.4 (10.4.10 and later) is still also supported.

In general, provided that working drivers are available for your hardware, we recommend Leopard over Tiger, since it has significant improvements internally that are relevant to Hauptwerk. The only notable disadvantage of Leopard is that it does not allow an application (such as Hauptwerk) to fill the memory as nearly as was possible with Tiger, so Hauptwerk might not be able to use as much memory on computers with 4 GB of memory or less. Please note that Hauptwerk currently runs as a 32-bit application on Mac OS X, and so cannot take full advantage of more than 4 GB of memory, but we hope to produce a native 64-bit version of Hauptwerk for Mac OS X 10.5 in a future release as soon as possible, which will allow sample sets to use more than 4 GB of memory. However, it is still currently advantageous to have more than 4 GB of installed memory, since OS X will allow Hauptwerk to use nearly 4 GB if there is further memory available for OS X itself to use.

Please check with your audio/MIDI interfaces' manufacturers for driver support before installing Leopard. Please also consult the Crumhorn Labs website for any updated recommendations.


ENHANCEMENT HW-000167: Voicing: new 'master' shortcut slider to move all sliders in rank at once (Advanced Edition only).

The Advanced Edition of Hauptwerk has per-pipe voicing facilities to allow the sound of a sample set to be adjusted to suit the acoustics of the listening environment and for aesthetic reasons. One slider is provided for each pipe in the selected rank and for the selected adjustment (e.g. brightness or amplitude). In addition to the 'quick' sliders previously provided to allow rapid adjustment of all pipe sliders within an octave (for the selected adjustment), a new 'master' slider is also provided. The slider works in the same way as the 'quick' sliders, but moves all of the pipe sliders equally for the whole rank (for the selected adjustment), rather than just affecting one octave. This slider is a very convenient tool for initial adjustment of the basic sound of each rank, and the organ as a whole, prior to fine-tuning the parameters at the octave or individual pipe levels with the other sliders.


ENHANCEMENT HW-000179: Voicing: window now non-modal so can engage/disengage stops without closing and re-opening voicing window (Advanced Edition only).

The Advanced Edition of Hauptwerk has per-pipe voicing facilities to allow the sound of a sample set to be adjusted to suit the acoustics of the listening environment and for aesthetic reasons. Previously, if controlling registration with the mouse or a touch-screen, it was necessary to close the voicing window, adjust the registration, then re-open it to be able to hear the effects of adjustments on a different rank, either individually or in combination, because the voicing window was 'modal' (no other window could be clicked whilst it was open). The window is no longer modal, and so you can now use the mouse or a touch-screen (in addition to MIDI, which was possible previously) to change registration freely whilst voicing. This makes the voicing process significantly faster and more convenient.


ENHANCEMENT HW-000243: A single MIDI input keyboard, switch, continuous control, rank, etc. can now control multiple virtual organ controls simultaneously.

Previously the settings screens did not allow a given MIDI object to control multiple virtual objects. For example, it was not natively possible to use a single MIDI keyboard to play two virtual keyboards at the same time (couplers etc. notwithstanding), or to trigger a single given virtual piston from either a thumb piston or a toe piston (unless the virtual organ explicitly provided additional pistons to accomplish that). Those restrictions have now been removed.


ENHANCEMENT HW-000413: New per-rank user option to disable multiple release samples.

A sample set can include multiple release samples for any give pipe to provide an extremely realistic virtual acoustic for wet sample sets, even when playing fast passages and short notes. However, such additional samples increase the amount of memory the sample set requires. There is a new per-rank user option to disable multiple release samples so that only the default release sample is loaded for each pipe in the rank, saving memory at the expense of realism when playing fast for such sample sets. There is also an equivalent new setting for multiple attack/sustain samples: see ENHANCEMENT HW-000533.


ENHANCEMENT HW-000431: Voicing: decibel parameter slider ranges increased from +/-12 dB to +/-24 dB (Advanced Edition only).

The Advanced Edition of Hauptwerk has per-pipe voicing facilities to allow the sound of a sample set to be adjusted to suit the acoustics of the listening environment and for aesthetic reasons. Previously, the maximum range of adjustments calibrated in decibels (amplitude, brightness, swell box and tremulant modulation, etc.) was +/-12 dB. Those adjustments now allow adjustment within a range of +/-24 dB, hence more extreme adjustments are possible.


ENHANCEMENT HW-000525: Maximum polyphony increased from 8192 to 32768 (Advanced Edition only).

Computers with eight processor cores, such as the 8-core Apple Mac Pro, can exceed the previous maximum Hauptwerk polyphony of 8192, hence we have increased the maximum polyphony to 32768 in the Advanced Edition. The maximum polyphony remains at 1024 in the smaller Basic Edition (previously known as the Studio Edition). Please note that the polyphony testing organ still only has about 8000 pipes, so polyphony limit values above about 8000 need to be set experimentally. Please also note that we strongly recommend not setting Hauptwerk's polyphony limit setting to a value higher than your hardware can achieve since the polyphony management system would not be able guarantee glitch-free audio in that case, and slightly more memory is consumed for higher polyphony limit settings.


ENHANCEMENT HW-000533: New per-rank user option to disable multiple attack samples.

The 'Organ | Load organ, adjust rank audio output routing' screen (also shown when a sample set is loaded for the first time) has a new setting: 'Multiple attack/sustain sample handling mode' which allows you to disable the use of multiple attack/sustain samples for sample sets that include them, thus saving memory at the expense of some realism. Multiple attack/sustain samples are used in some sample sets to model a pipe organ tracker-action response, to select samples randomly to reduce repetition, to give more realistic attacks to a pipe that sounds immediately after it has stopped speaking, and to give other improvements in realism. If you don't have sufficient memory to load the whole sample set, and the sample set includes both multiple attack/sustain samples and multiple release samples, it is generally best to disable multiple attack/sustain samples in preference to disabling multiple release samples, since multiple release samples give the most obvious improvement in realism. The equivalent new setting for multiple release samples is described in ENHANCEMENT HW-000413.


ENHANCEMENT HW-000555: Monitors free physical memory to prevent operating system crashing if memory completely exhausted.

Hauptwerk is able to guarantee that no sample memory will be cached ('paged') to disk, provided that you are logged onto your computer with an operating system user account that has administrator privileges, such as the default OS X or Windows account (see ENHANCEMENT HW-000483). When loading a sample set, Hauptwerk now also constantly monitors the amount of remaining free physical memory and stops a sample set loading if the free memory becomes very nearly exhausted. Doing so should ensure that there is sufficient free memory remaining for the operating system to use without risking the stability of the computer. Because Hauptwerk's data cannot be paged to disk, if the physical memory was to become completely filled then the computer could become very sluggish, appear to have frozen, or even crash completely. Such a freeze or crash was previously possible with Hauptwerk on Mac OS X, when no such mechanism was included. Please note that because Hauptwerk now deliberately reserves a small amount of free memory for the operating system, it is conceivable that a sample set that previously completely used up all available memory might now not be allowed to load with the same set of rank memory options. However, this should only occur in extreme cases, and we think that the gain in stability and resilience to audio glitches that is gained as a result is a worthwhile trade-off.


ENHANCEMENT HW-000581: Each menu function can now be triggered by up to four MIDI pistons/switches.

As covered in the 'Menus' section in the user guide, MIDI messages or computer keyboard key presses can be assigned to trigger Hauptwerk's menu functions. Previously each menu function could be triggered by at most one such MIDI switch or computer key. Now up to four are allowed, with additional settings on the 'General settings | Menu functions activated by switch (MIDI) inputs' provided for the purpose. For example, you might want to be able to trigger the registration sequencer's 'next' function from either a thumb piston or a toe piston.


ENHANCEMENT HW-000621: Voicing: now possible to click on sliders in addition to dragging them (Advanced Edition only).

In particular, this makes the voicing process considerably easier for touch-screen use.


ENHANCEMENT HW-000633: VSTi: Sibelius 5 now supported and tested as compatible VST host.

Sibelius is high-end musical notation software which supports play-back via VST instruments. Hauptwerk has been made compatible with it and Sibelius 5 is now fully supported as a VST host


ENHANCEMENT HW-000641: St. Anne's, Moseley organ sample set: additional virtual console display page tabs for dual-monitor stop jambs.

To allow the new multi-monitor support available in the Advanced Edition (ENHANCEMENT HW-000609) to be used and evaluated to best effect, two new display page tabs have been added to the St. Anne's, Moseley organ sample set's virtual console: one for the left stop jamb and another for the right. With two computer monitors (especially useful with touch-screens), it is now possible using the Advanced Edition to display each of those pages on a separate monitor, positioned either side of your MIDI console or MIDI keyboards for a realistic and ergonomic stop layout, i.e. with one stop jamb displayed on either side of your MIDI console. The virtual controls on the new virtual console pages are laid out to be especially suitable for touch-screen use.


ENHANCEMENT HW-000007: More advanced bass/melody coupler mechanism.

A bass or 'auto pedal' coupler duplicates the lowest note played on a manual to the pedalboard, which is very useful for playing organ music without a MIDI pedalboard, and for pianists who are not conversant with pedalling technique. Similarly, a melody coupler duplicates the highest note played on a manual onto another division, which is particular useful when playing an organ with two or more virtual manuals from a single MIDI keyboard. Hauptwerk's native bass and melody coupler implementation has been re-designed with a much more advanced mechanism. For a bass coupler, releasing the lowest key pressed no longer causes the next highest held key to sound, but special provision is also made to allow for ascending legato bass lines. The same is true for melody couplers, but for the highest note played and with provision for descending legato melody lines.


ENHANCEMENT HW-000274: MIDI feedback detected automatically (Advanced Edition only).

Whenever you load an organ or activate Hauptwerk's MIDI system, Hauptwerk now automatically sends special MIDI messages to try to detect if you have a virtual or physical MIDI lead connected between any of your selected MIDI OUT ports and MIDI IN ports. Having such a lead connected can crash or freeze Hauptwerk, the MIDI interface or your computer. By default, if MIDI feedback is detected Hauptwerk deactivates the MIDI system immediately and displays an error message. However, a new option 'Don't halt if MIDI feedback detected?' is provided on the 'General settings | General options' screen to disable this behaviour. Please only tick this option if you are absolutely certain that your MIDI console requires it, and if you are certain that your Hauptwerk configuration cannot cause any MIDI feedback with your MIDI hardware and wiring.


ENHANCEMENT HW-000384: Selected virtual console tab remembered when loading each organ.

Previously a fixed default display page/tab for the virtual console (defined by the sample set producer) was always selected when a sample set was loaded. Now that default is only used the first time that you load the sample set. Each subsequent time Hauptwerk now automatically selects the page tab that you last used for that sample set.


ENHANCEMENT HW-000439: Per-rank loss-less memory compression option turned on by default.

There is a per-rank user option to enable loss-less memory compression, which typically gives a 30-45 percent reduction in memory usage for a 10-15 percent reduction in polyphony and no loss of audio quality. When a sample set was first loaded the option previously defaulted to off (no memory compression). The default has now been changed to on (memory compression enabled), on the basis that it is preferable for a sample set to load successfully first time within the memory available, and the setting can then be fine-tuned as required to optimise performance for your hardware. This change only affects the first time you load a sample set; your existing sample set rank options will not be altered.


ENHANCEMENT HW-000446: 'Original organ tuning' selected by default when sample set first loaded.

The first time that you load a sample set Hauptwerk now defaults the initial temperament selection to the 'original organ tuning' option in preference to equal temperament. If a particular sample set does not support original organ tuning, then equal temperament is selected instead for it. The temperament can be changed as before using the Temperament menu, or the initial temperament mode changed on the 'Organ settings | General options' screen.


ENHANCEMENT HW-000543: Option to delay Hauptwerk launch when starting on boot to give time for slow MIDI/audio drivers to finish initialising.

Hauptwerk queries the audio and MIDI drivers installed in the computer when it starts. If Hauptwerk is configured to start automatically when the computer boots, then some audio/MIDI drivers might not have finished initialising at the point at which the operating system launches Hauptwerk, causing them to be missed and not available for selection in Hauptwerk. Some USB MIDI interfaces under Windows are known to be affected, such as the M-Audio MIDISPORT series. A new user option has been added to the 'General settings | General options' screen to cater for this situation: whenever Hauptwerk is launched it will now always wait for (at least) 'Minimum time to wait on start-up (seconds)' before starting. This setting is useful if you have Hauptwerk configured to start automatically when your computer starts, but some of your MIDI or audio devices are slow to start and might not have finished initialising when Hauptwerk is launched by the operating system. In all other cases you should leave this set to 0, to avoid making Hauptwerk unnecessarily slow to launch.


ENHANCEMENT HW-000561: Various memory statistics now shown in log file for diagnostics.

Memory usage diagnostic data, including the amount of available memory, free memory and approximate amount of sample memory in use by Hauptwerk, are now written to the log file (Help | Show error and activity log) to assist us when providing customer support.


ENHANCEMENT HW-000563: Hauptwerk Concert Edition renamed to Hauptwerk Advanced Edition and Hauptwerk Studio Edition renamed to Hauptwerk Basic Edition.

As before, there are two editions of Hauptwerk. The Advanced Edition has the full functionality and was previously known as the Concert Edition. The smaller edition, with a subset of the functionality, was previously named the Studio Edition, but has now been renamed to the Basic Edition. No existing functionality has been removed from the previous Studio Edition (in fact, there are many new enhancements to all editions, as can be seen from the list of changes in this release notice), and there is no intention to remove any functionality from it in the future. The changes of name are simply to help to clarify that the smaller Basic Edition has a subset of the full functionality of the Advanced Edition, rather than implying that either edition is necessarily best suited for any given type of users, which had caused confusion with the previous edition names. To emphasize: these are changes of name only, not functionality.


ENHANCEMENT HW-000584: Voicing: reset button moved to left of screen (Advanced Edition only).

The per-pipe voicing screen has a 'Reset' button that resets all sliders to their default position for the selected rank and adjustment. To make it harder to press the button by accident when intending to close the screen with the 'Close' button (especially for touch-screen use), the button has been moved to the opposite side of the screen.


ENHANCEMENT HW-000602: St. Anne's, Moseley organ sample set: duplicated toe pistons now accessible via MIDI.

The St. Anne's sample set included with Hauptwerk has some toe pistons that duplicate functionality provided by thumb pistons (for example, the five Swell divisional combinations). Previously those duplicated toe pistons were not configured to allow external control (via MIDI or computer keyboard key presses), since the thumb pistons provided the same functionality. Now they too allow external control.


ENHANCEMENT HW-000638: St Anne's, Moseley organ sample set: virtual controls and ranks renamed on organ settings screens.

So that the entries are shown in more logical orders on the 'Organ settings' screens and 'Organ | Load organ, adjusting rank audio output routing' screen, and to try to make their functions clearer, the names displayed on those configuration screens for the virtual controls and ranks have been changed. This has no functional effect and does not affect the appearance of the virtual console.


ENHANCEMENT HW-000433: Additional per-rank release sample truncation length settings and improved decay length scaling across rank compass.

Hauptwerk has a per-rank option to allow the user to specify that release samples should be truncated artificially, using specially-shaped frequency-dependent decays, to provide a basic simulation of 'dry' samples (with no reverb) from wet samples and to save memory. Different decay lengths are provided as options. In response to requests from some users, additional longer decay length settings are now available. The decay length scaling across the compass of a rank has also been improved.


ENHANCEMENT HW-000443: International character strings now stored in a more space-efficient format.

Hauptwerk now uses a different format internally to store character string data, which saves some memory but still allows the full range of international characters to be used as before.


ENHANCEMENT HW-000457: Dongle driver updated for Windows Vista compatibility (Windows only).

The previous version of the driver for Hauptwerk's licence key dongle was not compatible with Windows Vista, and an error was given during its installation. An updated driver is used in the installer for this version of Hauptwerk which is fully compatible with Windows Vista.


ENHANCEMENT HW-000498: [Sample set developers only] new organ definition setting to force an organ to load without compression.

A new _General.AudioEngine_DisableMemoryCompression setting is available in the organ definition file format. This exists only to ensure that the polyphony testing organ always loads without compression so its static polyphony is measured correctly. It is not intended that sample set developers would adjust this setting, and is listed here for their reference only.


ENHANCEMENT HW-000505: Additional resilience to unreliable audio or MIDI drivers being able to crash Hauptwerk during initialisation and activation or deactivation.

Hauptwerk queries installed audio and MIDI drivers when it is launched. If an unreliable audio or MIDI driver crashed during such a query, or when started or stopped, it could also cause Hauptwerk to crash. Hauptwerk now attempts to handle and suppress any such driver crashes. This is effective in most cases, although it is not possible to make Hauptwerk resilient to every conceivable driver crash, such as an audio driver crashing whilst Hauptwerk is actually streaming audio to it. Hence it is still strongly recommended that good-quality audio and MIDI interfaces with reliable drivers should be used.


ENHANCEMENT HW-000540: Known hardware and software synth virtual MIDI output ports ignored (Advanced Edition only).

The Advanced Edition has MIDI output capability. If a hardware or software synthesizer virtual MIDI output port is accidentally enabled as a MIDI output port in Hauptwerk, then unexpected percussion or other sounds can be heard when playing Hauptwerk or changing registrations. Windows' 'Microsoft GS Wavetable SW Synth' port and the Creative sound cards' 'SB X-Fi Synth ...' ports are common culprits. To try to prevent the possibility of these accidentally being selected as output ports in Hauptwerk, Hauptwerk now explicitly ignores those and other known virtual synth entries found on common sound cards when querying the list of available MIDI ports.


ENHANCEMENT HW-000546: [Sample set developers only] JPEG and TIFF image formats now supported in sample sets.

It is now possible to use these image file formats in sample sets, in addition to the BMP and PNG formats previously supported.


ENHANCEMENT HW-000556: Hauptwerk v1 import: sample data organised by organ definition name for compatibility with recently-released third-party Hauptwerk v1 sample sets.

Unlike the current format, the Hauptwerk version 1 sample set format had no formal means to guarantee uniqueness between sample file names, folder names or organ definition files. Some Hauptwerk version 1 sample sets released recently have sample folder names that conflict with other existing version 1 sample sets. Importing both such sample sets would cause the samples from one to overwrite the other. To try to guard against this, Hauptwerk now organises imported version 1 sample files and folders into sub-folders according to the imported organ definition file name. Please note, however, that there is still an implicit assumption that Hauptwerk version 1 organ definition filenames should be unique. To our knowledge, that remains the case with all publicly-available Hauptwerk version 1 sample sets to this date.


ENHANCEMENT HW-000560: Operating system and version shown in log file for diagnostics.

The operating system and version are now shown in the log file to assist us when providing customer support.


ENHANCEMENT HW-000618: Component installer: now possible to cancel installation during sample set extraction phase.

It was not previously possible to cancel the installation during extraction.


ENHANCEMENT HW-000619: Message no longer given if cancel loading organ from a MySQL database.

A spurious error message was given indicating that loading had been cancelled if you cancelled loading an organ from a MyQSL database (using the separately-licensed MySQL database integration option). No message is now given.


ENHANCEMENT HW-000628: Hauptwerk v1 import: re-importing a v1 organ file no longer re-defaults its settings.

If a Hauptwerk version 1 sample set is re-imported any existing organ-specific settings previously saved for it are now preserved. Please see BUG HW-000476 for more details.


ENHANCEMENT HW-000634: Moving Hauptwerk settings files between configurations and between PCs and Macs now technically possible.

Although Hauptwerk does not yet have fully a native means to transfer user settings between different Hauptwerk configurations (e.g. stand-alone and VSTi) or between different computers, all of Hauptwerk's settings are stored in XML files which can be copied between configurations and separate computers. Hauptwerk now automatically and seamlessly migrates settings within the files that are specific to one configuration or computer platform when the files have been transferred in that way. Please note that we do not recommend moving or adjusting any of Hauptwerk's internal files, including its settings files, without having specifically been advised to do so by Crumhorn Labs, since it is possible to damage your Hauptwerk installation if a mistake is made. If you have only a few settings to migrate between different configurations or computers, please simply re-make those settings changes via the settings screens on the new configuration or computer. If you have a very large number of settings that you need to migrate between separate installations, and are reasonably experienced with computers, then we can provide advice on such a migration on request.


ENHANCEMENT HW-000640: Computer key code numbers changed for switch (MIDI) inputs screen.

The computer key code numbers used on the 'General settings | Switch (MIDI) inputs' screen to allow computer keys to trigger virtual organ controls have changed. This was necessary because the major version of the multi-platform library used within Hauptwerk has been updated in order to be able to provide full support for Windows Vista and the forthcoming Mac OS X 10.5 and because the key code numbers are defined by that multi-platform library. When you first launch Hauptwerk version 3 it will automatically attempt to migrate any keys settings that you had defined with an earlier version to the new numbering scheme. The new key codes are listed in full in the 'MIDI implementation' section in the user guide. However, there are a small number of key codes (previously numbered as 224-246 and 248-254) from the 'Latin 1' range for which there are no equivalents in the new version. Hence please briefly check that any key assignments that you had previously configured are still functioning, and re-configure them if they fell in to those ranges. There are also some additional new key codes, and the number of available key code numbers has risen overall.


ENHANCEMENT HW-000643: St. Anne's, Moseley organ sample set: CRESC TO SW and CRESC TO PED pistons moved on virtual console.

The order in which the Crescendo couplers are laid out on the main display page of the St. Anne's, Moseley organ sample set's virtual console has been changed for consistency with other types of couplers.


ENHANCEMENT HW-000662: [Sample set developers only] Much easier-to-use native support for theatre organ traps, pizzicato and re-iterators and for stop action noise effects.

Although it was previously possible to implement all of these things in the full native organ definition format, it was quite complicated. More native supported has been added to make the task of including such features much quicker and simpler for the sample set producer. The ActionTypeCode and ActionEffectCode parameters are new or extended for the KeyAction and StopRank tables, together with new PipeMIDINoteNum036_PizzOrReitPeriodMs and PipeMIDINoteNum096_PizzOrReitPeriodMs parameters for both of those tables. Please consult the Sample Set Creator's Guide for a full list of the new action type and action effect codes if required.


ENHANCEMENT HW-000663: [Sample set developers only] Internal keyboards for coupling no longer need to be visible to the user via the organ settings screens.

Sometimes it is desirable for a sample set creator to create hidden internal Keyboard objects within the organ definition to implement complex coupling or other mechanisms. Previously, although those keyboards need not be displayed on the virtual console, they were visible to the user via the 'Organ settings | Connect keyboard MIDI inputs to organ keyboards' and 'Organ settings | Connect organ keyboards to keyboard MIDI outputs' screens, which could be confusing to the user. Two new settings have added to the Keyboard table to prevent that behaviour if required: AccessibleForInput and AccessibleForOutput.


ENHANCEMENT HW-000664: [Sample set developers only] Much easier-to-use native support for re-triggering and non re-triggering tremmed sample ranks.

Some sample set developers prefer the use of real tremulant-affected ('tremmed') samples to using Hauptwerk's native tremulant model. Also some of those sample set producers prefer held notes not to re-trigger when the user switches between the un-tremmed and tremmed versions of the ranks (i.e. engages or disengages the tremulant switch). Although it was previously possible to implement in the full native organ definition format, it was quite complicated. More native supported has been added to make the task of including such a feature much quicker and simpler for the sample set producer. The following new parameters have been added to the StopRank organ definition table to accomplish this: SwitchIDToSwitchToAlternateRank, RetriggerNotesWhenSwitchingBetweenNormalAndAlternateRanks, AlternateRankID, AlternateExternalRankID. If SwitchIDToSwitchToAlternateRank is specified, then Hauptwerk will switch between the main rank specified and the 'alternate' rank, optionally re-triggering held notes depending upon RetriggerNotesWhenSwitchingBetweenNormalAndAlternateRanks.


ENHANCEMENT HW-000665: [Sample set developers only] Image size settings no longer need to be specified manually.

When listing image files in the ImageSet and ImageSetElement tables in the organ definition, it was previously necessary to specify the image size with ImageSet.ImageWidthPixels and ImageSet.ImageHeightPixels. Those values can be now left blank (or zero), in which case Hauptwerk will automatically determine the image sizes from the image files themselves.


ENHANCEMENT HW-000669: Various usability/cosmetic enhancements to settings screens, file browsers and other dialogue windows.

In particular, pressing ENTER/RETURN on any settings screen, file browse window or other dialogue window is equivalent to clicking the OK button, and pressing ESCAPE is equivalent to clicking the Cancel button, regardless of the highlighted item on that screen. This makes it significantly quicker to perform many common operations using the keyboard. Most file browse windows now automatically default to having the last-used item selected and the sorting behaviour for the lists of files they show has been improved.


BUG HW-000017: If a combination file was loaded at the same time as notes were being played, sometimes the notes were not released.

When loading a combination file, the stops and controls were reset correctly, but sometimes the keys were not, causing notes to stick until 'Functions | Reset' was selected from the menu.


BUG HW-000199: Was very occasionally possible to cause a crash by deactivating/unloading at exactly the instant that a MIDI message was being processed.

A virtual console screen update resulting from the MIDI message could conflict with the screen handling during deactivation.


BUG HW-000427: Crash could occur with some sample sets if blower turned off and wind regulators allowed to deflate fully (Non-USA Advanced Edition only).

The Advanced Edition of Hauptwerk includes a physical model of a pipe organ wind supply (not available in the U.S.A.). Some sample sets include a blower switch, which allows the wind regulators to deflate. If the regulators were allowed to deflate fully whilst pipes were sounding a crash could sometimes occur.


BUG HW-000469: Bug in Creative X-Fi ASIO driver could cause Hauptwerk to lose user settings changes (Windows only).

Hauptwerk queries the installed audio devices when it starts. Due to a bug in the Creative X-Fi ASIO driver whereby the driver gives an invalid response when queried, if you had a Creative X-Fi sound card installed in the PC, Hauptwerk could show error 'ERR:1132 Failed to validate the 'ChannelGroupNumber' attribute of the 'AudioOutputDeviceChannel' object' in its log file, followed by 'INF:4116 The main Hauptwerk configuration file Config.Hauptwerk.xml, located in the configuration file folder, could not be loaded successfully and may have been corrupt or contained invalid settings or values. Hauptwerk successfully restored and loaded the file automatically from backup. However, some previous settings changes may have been lost as a result.' The main effect of this was that any settings changes you made would be lost when you next started Hauptwerk. Hauptwerk has been changed to work around the driver bug explicitly, so that the invalid responses from the Creative driver no longer cause any errors to be reported or Hauptwerk settings to be lost or reverted.


BUG HW-000470: Some audio interfaces' ASIO buffer sizes could not be adjusted without external access to the drivers' ASIO control panel (Windows only).

In Hauptwerk version 2.20 the option to open the audio interface driver's ASIO control panel was removed from the Hauptwerk menu and instead the ASIO buffer size was made adjustable via the 'General settings | Audio outputs' screen, since that was felt to be more user-friendly. However, some audio drivers, such as the Echo Gina/Darla ASIO driver, ignore any requested ASIO buffer sizes and only uses the value set via their own ASIO control panel. Since that control panel is not accessible via all drivers' audio control panel utilities and was no longer accessible via Hauptwerk, the ASIO buffer size could not be adjusted for those interfaces. A new button has been added to the 'General settings | Audio outputs' screen to open any selected ASIO driver's ASIO control panel, thus allowing the buffer size to be adjusted again natively for such devices.


BUG HW-000490: If Steinberg's emulated 'ASIO DirectX' or 'ASIO Multimedia' drivers were corrupted Hauptwerk would not launch (Windows only).

Most Steinberg products, such as Cubase, Cubasis and V-STack, install two emulated drivers named 'ASIO DirectX Full Duplex Driver' and 'ASIO Multimedia Driver'. Those drivers maintain databases of other Windows drivers and provide an emulated ASIO interface to them. They do not give good performance with Hauptwerk, and their driver databases frequently become corrupted if audio interfaces or drivers are added or removed. It is possible to identify whether the drivers have become corrupted by trying to open the 'ASIO DirectX Full Duplex Setup' or 'ASIO Multimedia Setup' utilities found in the Start menu program group for your Steinberg application(s). If one of the drivers has become corrupted, its corresponding Steinberg set-up utility will crash or fail to open. Hauptwerk queries installed drivers when it launches. If a driver crashes or freezes when queried, that can cause Hauptwerk itself to crash or freeze. Since those particular drivers frequently became corrupted and crashed, causing Hauptwerk to crash on launch, and since those drivers are not relevant to Hauptwerk anyway, Hauptwerk now explicitly ignores those two drivers when querying the installed audio drivers. Thus it should no longer affect Hauptwerk if the Steinberg emulated drivers become corrupted.


BUG HW-000491: Transposer could leave keys stuck if transposition changed whilst holding keys.

If a chord was held whilst the transposition was changed, the keys that were previously pressed could incorrectly remain pressed. Keys are now correctly released when changing the transposition.


BUG HW-000612: Was possible to cause a crash by triggering two system functions at exactly the same time (e.g. one via the menu and another with a keyboard shortcut).

A system function can now only be triggered once any previous system function has completed.


BUG HW-000622: Notes could hang if registration sequencer frame was advanced/decremented rapidly whilst playing.

The problem is now fixed.


BUG HW-000400: Installer: non-English or non alpha-numeric characters in installation folder names could prevent Hauptwerk launching (Windows only).

Characters other than a-z, A-Z, 0-9, space, underscore and hyphen (such as an ampersand) could be incorrectly encoded into Hauptwerk's XML settings files by the installer, preventing Hauptwerk from reading the folder names correctly. In such cases you could see error 1108 (XML parsing error) in a file named FileLocations.Hauptwerk.xml when you attempted to launch Hauptwerk. Special characters should now be encoded correctly by the installer, so any folder names valid for the operating system should be acceptable on Windows PCs. Please note that non-English characters in installation folder names may still cause problems on Mac OS X and additional work will be needed to address the issue fully on that platform (see bug HW-000679). Hence please still use only the a-z, A-Z, 0-9, space, underscore and hyphen characters in folder names when installing Hauptwerk on Mac OS X.


BUG HW-000424: Component installer: crash during sample set installation was possible with large sample sets (Windows only).

In previous versions of Hauptwerk it was recommended that Windows' virtual memory should be disabled to prevent Hauptwerk's sample data being cached ('paged') to disk. This is no longer necessary (see ENHANCEMENT HW-000483) since Hauptwerk now guarantees that sample data are kept only in physical memory, and we now recommend keeping Windows virtual memory enabled. Hauptwerk's component installer (used when installing sample sets) calls a third-party utility to extract the sample set data, which could sometimes crash when installing very large sample sets, causing Hauptwerk itself to crash. This usually occurred when Windows virtual memory was disabled or exhausted and should no longer happen. Hauptwerk also now attempts to trap and handle any crashes from the third-party utility so that Hauptwerk itself should not crash even if a virtual memory shortage does still arise.


BUG HW-000432: Component installer: was still slow to read some sample sets from DVD or CD (Windows only).

Although previous versions included speed enhancements in this area, when installing certain sample sets from CD or DVD, Hauptwerk's component installer could still be slow to read the CDs/DVDs on Windows PCs. Additional optimisation has been added that now ensures that all CDs and DVDs are read at least as fast as Windows Explorer is able to copy files from them. This reduces the overall time taken to install such sample sets very significantly.


BUG HW-000436: [Sample set developers only] If sample and output sample rates differed then original organ tuning option gave the wrong pitch.

If one or more samples within a sample set was saved using a different sample rate to the global output sample rate for the sample set, then Hauptwerk's 'original organ pitch' temperament option (only) could cause those samples to sound at the wrong pitch. This was not known to affect any current sample sets and has now been corrected.


BUG HW-000441: Markers within a sample were numbered backwards.

If a sample had more than one marker (WAV 'cue point') within it and the sample set specified where the pipe release should start using the marker number, then the wrong marker might be used because Hauptwerk (versions 2.10 to 2.21 only) numbered them backwards from the end of the sample, whereas they should be numbered forwards from the start. This was only known to affect some Sonus Paradisi/Hauptwerk.cz sample sets, giving less prominent decay transients than intended for those sample sets, and has now been rectified.


BUG HW-000474: Installer: froze during installation on a few Apple Macs (Mac OS X only).

Hauptwerk's installer is a Java application and relies upon the Java system within Mac OS X. A few users reported to us that the installer froze on certain Macs, either during its initialisation or during the installation phase (usually when installation shows that UninstallHauptwerk.app was being installed). This appeared to occur if OS X's Java installation was not fully current, if 1.4 rather than 1.5 was selected for OS X's default Java version, or if OS X's Java installation had become corrupted. Hauptwerk's installer has now been changed to use Java version 1.5 only, regardless of OS X's default Java version setting. We believe that has addressed the problem. If you do still experience the problem, please first wait for a few minutes to ensure that the installer has genuinely frozen, rather than just running slowly. Please then ensure that all current OS X updates have been applied (click on the Apple icon at the top-left of your screen and select 'Software Update ...' and allow it to apply all updates, especially any relating to Java). Reboot if any updates were applied. If that doesn't solve the problem, please let us know.


BUG HW-000480: Licensed copies of Hauptwerk could start in evaluation mode if launched automatically on boot (Mac OS X only) and new option to wait for dongle to be found on start-up.

On Mac OS X it is possible to make an application such as Hauptwerk launch automatically when the computer is booted by adding it to the 'Login Items' list for a given operating system account in the Accounts preferences pane within the System Preferences utility, or by dragging the Hauptwerk short-cut to the Dock and right-clicking on it. However, if your computer has only a single user account, with its login options set to log into that account automatically (i.e. no login screen is displayed, which might be the case if you wanted to use the computer purely as an engine for running Hauptwerk, with no direct interaction with the computer), then OS X can start very rapidly, and could log in and launch Hauptwerk before the dongle driver had finished initialising, causing Hauptwerk to start in evaluation mode. To avoid this problem, a new setting has been added to the 'General settings | General options' screen: if Hauptwerk has previously been launched at least once with a licence key dongle attached to the computer, but the dongle is not found when you subsequently launch Hauptwerk, it will now wait for the time specified by 'Maximum time to wait for licence key dongle on start-up (seconds)' before starting in evaluation mode. This is mainly useful if you have Hauptwerk configured to start automatically when your computer starts. You can set value to 0 if you wish to disable the delay entirely. However, the delay has no effect if the dongle is found immediately, thus no unnecessary delay should be introduced when starting Hauptwerk.


BUG HW-000518: Audio output device channel names sometimes showed incorrectly if configured for multiple audio devices at once (Mac OS X only).

If Hauptwerk was configured to use multiple audio device drivers (separate physical audio devices) simultaneously for multi-channel audio on Mac OS X then the device channel names on 'General settings | Audio outputs' could sometimes be shown with an incorrect value, although the correct channel would still be used. The device channels now always show the correct selected value.


BUG HW-000617: Voicing: swell box harmonic content adjustment was not always select-able (Advanced Edition only).

The 'Swell boxes: harmonic content (dB)' setting on the per-pipe voicing screen sometimes did not appear in the list of adjustments when it should, preventing it being adjusted. It is now correctly available whenever the user has not be disabled swell box filters.


BUG HW-000627: Invalid audio or MIDI drivers could cause Hauptwerk to crash on launch (Mac OS X only).

Hauptwerk queries the audio and MIDI devices available when it is launched. If a device driver returned an error code when queried, in some circumstances Hauptwerk could crash. Error codes being returned by device drivers are now handled correctly.


BUG HW-000635: Installer: performing custom installation to root of hard-drive prevented organ information displaying and component installer patching (Windows only).

If the root of a hard-drive was selected as the destination for a custom installation in Hauptwerk's installer, then 'Organ | Show organ information ...' might not work or might cause a crash. The component installer might also not be unable to apply sample set patches. The installer has now been changed to handle installation to the root of a hard-drive correctly.


BUG HW-000637: Excessively high audio output level causing severe clipping could crash some audio drivers (Windows only).

Having Hauptwerk's audio output level set so high that extreme distortion ('clipping') occurred could crash some Windows audio drivers, such as the M-Audio ASIO driver. Hauptwerk now explicitly clips the signal before sending it to the driver to guard against such problems.


BUG HW-000670: Was possible under certain circumstances to load an organ when audio configuration was invalid, causing crash or strange audio routing.

If Hauptwerk's user audio configuration settings are invalid, for example if no audio outputs have been included in a given audio output group, then Hauptwerk displays a warning message and disables most of the menu items until that invalid configuration has been corrected by the user. However, there were some circumstances under which it was still possible to load an organ, which could cause a crash whilst the organ loaded and/or strange audio routing could be heard. Hauptwerk now correctly prevents an organ being loaded if the user audio configuration is invalid.


BUG HW-000682: Computer keyboard layout could change to Dvorak on PowerPC G4/G5 Macs running OS X 10.4 (Mac OS X only).

A few users reported that their Mac OS X keyboard layout had very occasionally changed to the 'Dvorak' layout after running Hauptwerk on PowerPC G4/G5 Macs (only), with Roman-based layouts (e.g. Western European variants) having disappeared from the list of available layouts. Hauptwerk itself never reads or writes any of OS X's settings or files, and, despite a great deal of investigation from both parties, neither Apple nor Crumhorn Labs were able to reproduce this problem reliably. We suspect that the problem was actually a bug in OS X that was getting triggered as an indirect result of Hauptwerk version 2. As a precautionary measure, for Hauptwerk version 2 and OS X 10.4 on PowerPC G4/G5 Macs we recommended installing and running Hauptwerk using a different OS X user account to your main account, so that the keyboard layout settings for your main user account could not be affected if the issue arose. If the problem had arisen, the correct list of keyboard layouts could be restored by using Finder to navigate to /Library/Caches then deleting each file in that folder with a name starting with 'com.apple.IntlDataCache'. Doing so would cause OS X to regenerate its settings caches correctly. For version 3 we have moved to new major versions of all of the tools and libraries used within Hauptwerk, and have made major changes to several key parts of Hauptwerk that interact with OS X in an attempt to eliminate the problem. In particular, on OS X 10.5 'Leopard' it is no longer necessary (or possible) to lock large amounts of data into physical memory, since Leopard's memory management is much better than OS X 10.4's. Attempting to lock too much memory on OS X 10.4 could cause strange and unpredictable operating system problems and crashes, which we think is the most likely explanation for this problem. Whilst we cannot be 100 percent certain that the problem is now fixed, since it only occurred extremely rarely, and its cause could not be fully identified by Apple or Crumhorn Labs, as a result of the extensive changes we've made in Hauptwerk version 3, and the significant changes within Leopard, we are confident that the problem will no longer occur if you use Hauptwerk version 3 and above on OS X 10.5 (Leopard).


BUG HW-000009: Main window occasionally not resized if switched apps during de/activation.

It very occasionally happened that the main window was not resized properly when switching to another application during activation/deactivation.


BUG HW-000287: Global setting to disable multiple loops should reload any currently-loaded organ.

Changing the 'Disable multiple sample loops' setting on the 'General settings | General options | Audio Engine' screen should cause any currently-loaded organ to be re-loaded, but did not.


BUG HW-000435: CODM: very large numbers of virtual divisions or swell boxes could cause memory error or crash on activation.

This has now been rectified. Please note, however, that large numbers of divisions or swell boxes increase the processing load for the wind supply model (not available in the U.S.A.), so should still be used with caution in order to avoid excessive reductions in polyphony if the wind supply model is enabled.


BUG HW-000444: CODM: specifying an enclosure for a non-existent division caused a crash.

In the Custom Organ Design Module, if an enclosure was included for a division that did not exist for the organ, Hauptwerk would crash when attempting to load the custom organ. It now correctly gives an error message.


BUG HW-000452: VSTi: Auto-load organ option gave VST error message.

Using the 'General settings | General options' screen to set the 'Organ loading mode when Hauptwerk starts' setting to anything other than 'Normal' could cause the VST host program to give an error indicating that the plug-in failed to install/initialise when launching. This has now been fixed. Please note, however, that some hosts (notably Sonar and Cubase 4) instantiate and open all installed plug-ins when they start, causing the organ to load every time that the host is opened, which can be very slow. Hence in general it is still recommended that you use the VST host's VST program selection for the Hauptwerk plug-in to select the organ to load instead, which allows a Hauptwerk stand-by organ to be chosen and is usually saved in the VST host program's project file.


BUG HW-000461: CODM: Unnecessary unique constraints on StopRank table.

In the Custom Organ Design Module (CODM) there was a unique constraint on the StopRank table on the fields (StopCode, RankID) and another on (StopCode, ExternalRankID). Those constraints were not necessary, and prevented a given rank being referenced multiple times with partial compasses for a given stop, for example to use it within several parts of a mixture or other compound stop. This did not affect the main organ definition file format. The unnecessary constraints have now been removed.


BUG HW-000485: Component installer: progress indicator re-started repeatedly when installing sample sets above 2 GB in size.

For component packages (sample sets) larger than 2 GB, during the initial phase of reading/preparing the data, the progress indicator displayed by Hauptwerk's component installer could scan from 0 to 100 percent repeatedly, rather than displaying the true progress values. This had no functional impact, in that the component installer would still process such packages correctly. The progress indicator now displays the correct values with component packages of any size.


BUG HW-000487: Small brief crackle/audio glitch could be heard when minimising the main Hauptwerk window (Windows only).

If Windows virtual memory was enabled, minimising the main Hauptwerk window whilst pipes were sounding could cause a small audio glitch or crackle because Windows would automatically move all of Hauptwerk's data to its disk cache ('page file'). Hauptwerk now locks all of its data into physical memory on Windows (as it previously did on Mac OS X), so this problem can no longer occur provided that you are logged onto your computer with an operating system user account that has administrator privileges, such as the default Windows account. Please see ENHANCEMENT HW-000483 for more details. As described there, we now recommend keeping Windows virtual memory enabled.


BUG HW-000502: LCD status display panel text was misaligned if organ short name was less than sixteen characters in length (Advanced Edition only).

The Hauptwerk Advanced Edition has the ability to drive an LCD display panel to show Hauptwerk's status, including an abbreviated form of the name of the organ loaded. If the abbreviated name was less than sixteen characters in length, the alignment of the other information on the display was not correct on the LCD panel. Hauptwerk now pads the abbreviated name automatically with spaces as necessary.


BUG HW-000517: Switching the dongle attached to a given computer gave confusing message when re-loading a sample set for the first time.

For customers and re-sellers that have multiple licences for Hauptwerk, and thus have several USB licence key dongles, changing the dongle attached to a given computer could give a confusing error message about the sample cache being invalid the first time that each sample set was re-loaded unless the sample cache was explicitly re-generated by loading the sample set with 'Organ | Load organ, adjusting rank audio output routing'. Acknowledging the message and then re-loading would allow the organ to load correctly. Hauptwerk now automatically detects whether the sample cache was saved with a different dongle attached and re-generates the caches transparently when necessary.


BUG HW-000530: If Hauptwerk was closed during activation then configuration settings changes could be reverted.

Hauptwerk saves its general configuration settings when it closes. If Hauptwerk was closed, or if the computer was shut down, at exactly the moment that an organ had finished loading and the audio and MIDI systems were being started, then invalid values could be saved to its configuration file. The effect of this was that Hauptwerk would detect that the settings file was corrupted when it was next started and automatically revert the settings from a backup of the configuration file from the last point in time at which it had been loaded successfully. Hence any settings changes made in the previous session could be lost. It has now been changed so that activation of the audio and MIDI systems is allowed to complete safely before any shut-down request is processed, ensuring that the settings are written correctly in this (unusual) case.


BUG HW-000534: [Sample set developers only] If multiple mono attack and release samples were used at the same time for a given pipe extreme distortion could occur.

When loading into memory the sample data was becoming corrupted in this case (only), causing strange sounds and distortion. This did not affect any publicly-available sample sets and has now been rectified.


BUG HW-000551: When deactivating/unloading organ LCD panel text was not cleared (Advanced Edition only).

The Hauptwerk Advanced Edition has the ability to drive LCD display panels to show the names of draw-knobs and other virtual controls alongside their associated MIDI draw-knobs/tab/pistons on MIDI consoles, with the correct values for each distinct sample set. It can also use a single additional LCD panel to show status information. When a sample set was unloaded or deactivated, the LCD panel text was not previously cleared, leaving misleading text displayed on the MIDI console. The LCD panels are now always cleared when a sample set is unloaded or audio/MIDI are deactivated.


BUG HW-000553: During audio/MIDI activation/deactivation LCD panel messages were sent 4-5 times in a row (Advanced Edition only).

The Hauptwerk Advanced Edition has the ability to drive LCD display panels to show the names of draw-knobs and other virtual controls alongside their associated MIDI draw-knobs/tab/pistons on MIDI consoles, with the correct values for each distinct sample set. It can also use a single additional LCD panel to show status information. Previously when a sample set was loaded, unloaded or the audio/MIDI systems activated/deactivated, the text would be sent to all configured LCD panels 4-5 times in a row, potentially generating a large and unnecessary amount of MIDI traffic, which could cause problems with some MIDI interfaces with less buffering. Message text is now sent once only in each case.


BUG HW-000606: Various menu short-cut key combinations re-assigned since some short-cuts weren't working on OS X.

Some of the key combinations previously assigned to menu items weren't working under OS X because they had special reserved functions within OS X itself. To address this, menu short-cuts are now triggered by using both the Control and Alt keys on OS X, rather than just the Alt key. For example Control + Alt + F1 loads the first stand-by organ. On a Windows PC the Ctrl key is used in combination with the short-cut key as before. It has also been necessary to re-assign various menu short-cuts to ensure consistency between OS X and Windows whilst avoiding reserved key combinations on both platforms. Hence please check the menu short-cut key combinations again if you used them with previous versions.


BUG HW-000607: Stand-by menu entries weren't appearing to be updated when 'set stand-by' sub-menus were used for assignment.

The stand-by entries on various menus provide convenient short-cuts to load particular organs, temperaments or combinations. The 'set stand-by' sub-menus provide options to assign currently-loaded items to those stand-by entries. However, assigning items with those sub-menus did not always cause the text of the main menus to be refreshed, so sometimes it would appear that the assignment had not worked. The menus now refresh correctly.


BUG HW-000614: Settings screen layouts could be incorrect if user had customised Windows default font size (Windows only).

Windows has a setting that allows the user to customise its default font size. If a custom value other than the two defaults of 96 DPI and 120 DPI was chosen, then the layout of Hauptwerk's settings screens could make some settings illegible. Hauptwerk now ignores font size settings above 120 DPI to ensure the screens remain legible whatever Windows font size has been selected.


BUG HW-000632: VSTi: unloading Hauptwerk VST plug-in whilst loading organ or installing sample set could cause crash/freeze.

Unloading the Hauptwerk VST plug-in by removing it from the VST host's current project or by closing the VST host's project whilst Hauptwerk was loading an organ or installing a sample set could previously cause the host to crash or freeze. This has now been corrected. Please note, however, that some hosts (notably Cakewalk Sonar) can still crash or freeze if you attempt to close the host application whilst the Hauptwerk plug-in is loading an organ or installing a sample set, without cancelling the action in Hauptwerk first. We have not found a way around that at this stage (see BUG HW-000636).


BUG HW-000002: MIDI system exclusive errors in log when deactivating (Advanced Edition only).

Very occasionally, and on certain computers configured to control large numbers of LCD panels using Hauptwerk's LCD panel system, a large batch of errors (ERR: 3840) appeared in the log file during deactivation, relating to failure to send LCD system exclusive messages. We believe that was due to the MIDI interface driver's buffer becoming flooded. The volume of MIDI messages sent to the LCD panels has now been reduced very significantly, since many of the messages being sent were actually duplicates and thus unnecessary. This appears to have successfully prevented the problem from recurring with good quality (sufficiently-buffered) MIDI interfaces.


BUG HW-000012: [Sample set developers only] If an invalid organ info file was specified in an organ definition, Hauptwerk could crash.

If a sample set developer specified an invalid/non-existent organ-info file in the organ definition file for the sample set then Hauptwerk could crash when 'Organ | Show organ information' was clicked.


BUG HW-000014: [Sample set developers only] If a sample set image file was missing, the loading progress indicator was not closed after the error.

When creating a sample set, if an image file was specified which was not present, then an error message was given correctly, but the loading progress indicator was not closed.


BUG HW-000184: CODM documentation: trivial error in Custom Organ Design Module user's guide.

The description of the StopRank.MIDINoteNumOfFirstMappedDivisionKey field in the Custom Organ Design Module (CODM) user's guide had a minor error.


BUG HW-000267: Hauptwerk v1 import: minor difference in behaviour between v1.2x and v2.1x with one Sonus Paradisi Doksy-Kruh v1 organ definition file.

The 'compound mixture' version of the Hauptwerk version 1 organ definition file for the Sonus Paradisi Doksy-Kruh sample set assigns several stops to the same MIDI note number. When imported into Hauptwerk version 2.10+, those are presented as multiple stops, and could not be mapped to a single MIDI switch. As far as we know, that was the only Hauptwerk version 1 organ definition configured in that way (multi-rank stops controlled by a virtual invisible keyboard in a version 1 organ definition file work as expected, which was the conventional way to control multi-rank stops in version 1). It is no longer a problem because it is now possible to assign several virtual stops to be controlled from a single MIDI switch (e.g. MIDI draw-knob/tab or computer key), as covered in ENHANCEMENT HW-000243.


BUG HW-000276: VSTi: crash on launch if Hauptwerk's main configuration file had been deleted/moved.

If Hauptwerk's main configuration file had accidentally been moved or deleted by the user, launching the Hauptwerk VSTi plug-in would correctly show error message 4114 (indicating that its settings file could not be found) but then crash. It now shows the error message and exits properly.


BUG HW-000314: Hauptwerk v1 import: error was given if Enclosure.AmplitudeMinimumLevel was greater than 60.

When importing a Hauptwerk version 1 organ, an error would be given if the [Enclosure] AmplitudeMinimumLevel setting in the v1 organ definition file was greater than approximately 60. This did not affect any commercial version 1 sample sets and the setting would not normally be set that high, so it was very unlikely to affect user-created organ definitions.


BUG HW-000465: Component installer: error message 1223 (can't read organ definition because no valid licence found) clarified.

If attempting to install a protected sample set when no valid licence had been installed on the USB licence key dongle for the sample set, Hauptwerk's component installer gives error message 1223. The text of the message was somewhat confusing, and has been clarified.


BUG HW-000468: MySQL database integration: backslash character in a filename gave XML parsing error.

The separately-licensed MySQL database integration option allows organ definition files to be exported to and imported from a MySQL database as a tool for sample set development. If an organ definition file contained a backslash character then incorrect data could be exported to the database (since a backslash character has a special meaning in SQL scripts), which could give error 'ERR:1108 XML parsing error at line NN [not well-formed]' when the database was imported back into Hauptwerk. This has now been corrected. Note also that Hauptwerk interprets both forward-slash and backslash character as valid directory separators for compatibility with both Windows and Mac OS X.


BUG HW-000475: CODM: General tremulant could not be included.

In the Custom Organ Design Module, attempting to include a general tremulant in the organ specification caused an error message.


BUG HW-000476: Hauptwerk v1 import: imported organs could be slow to load the first time and their organ-specific settings could be lost/overwritten if importing from multiple configurations alternately.

Hauptwerk identifies each organ by an ID number, which is globally unique across all sample sets and organs. All organ-specific settings for the organ are stored relative to that ID number to enable Hauptwerk to identify which settings relate to the organ. For sample sets in the native version 2 sample format and later that ID number is assigned centrally by Crumhorn Labs to guarantee uniqueness. However, the Hauptwerk version 1 format did not have any means of identifying organs uniquely since Hauptwerk version 1 did not have any organ-specific settings. Hence when a version 1 organ is imported, Hauptwerk must generate a new ID number to identify it so that settings can be saved for it. Previously, Hauptwerk attempted to ensure that the number was unique by assigning IDs incrementally for each imported version 1 organ from within a range of numbers reserved from the purpose. The last-allocated ID number used for importing version 1 organs was stored internally in the global settings for each Hauptwerk configuration (stand-alone, MIDI sequencer or VSTi). However, if you reinstalled Hauptwerk, reverted some but not all of its settings (which can happen if you use Windows System Restore), or imported version 1 organs from multiple configurations alternately, the last-allocated ID number for the configuration might no longer have been accurate, causing an imported version 1 organ to be assigned an ID number that had previously been assigned to another version 1 organ. The effect of this was that the organ might be very slow to load the first time after it had been imported and its organ-specific settings could be incorrect. We have now changed the version 1 organ importing mechanism to search all configurations for evidence of a given ID number having been used previously before assigning it. If the ID had previously been used and the version 1 organ definition filename matches that being imported, then it is reused so that previous settings saved for the organ should be preserved if importing the same version 1 organ definition file multiple times. If the ID had been used for a different version 1 organ definition file, then it is not now reused, preventing incorrect settings being applied to the newly-imported version 1 organ in the above cases.


BUG HW-000552: First registration frame in status bar showed as 000 but 001 on LCD status display panel.

The status bar at the bottom of the main Hauptwerk window displays the combination sequencer registration frame number. The value was previously displayed using numbering starting at 000 for the first frame, which was not consistent with the LCD status display panel (Advanced Edition only), numbered from 001. The status bar display has now been changed also to use numbering starting from 001, which is considered more user-friendly.


BUG HW-000597: Ctrl/Alt+Y menu short-cut was duplicated between re-directable routes and original organ tuning.

This has been addressed as part of BUG HW-000606.


BUG HW-000608: Some entries on the Temperaments menu were not showing as disabled on OS X at times that they should have been (Mac OS X only).

The menu items are now shown in their correct states at all times.


BUG HW-000629: Hauptwerk v1 import: re-importing a v1 organ with updated sample files could leave sample caches in invalid state.

Whenever a Hauptwerk version 1 sample set is imported, Hauptwerk's sample caches are invalidated to ensure that any changes to samples within a re-imported sample set are picked up correctly. Please note, however, that we don't recommend creating new sample sets in Hauptwerk version 1 format.


BUG HW-000653: CODM: example organ 1 had slightly misleading setting for Samples_SampleMIDINoteNumOfLastAvailableSample.

For the 56-pipe manual ranks in the Custom Organ Design Module example organ 1 the Rank.Samples_SampleMIDINoteNumOfLastAvailableSample setting was set to 92, rather than the expected 91. This did not make any functional difference in this case since the value only defines the range of samples available.



Changes in version 2.21

Version 2.21 included mainly bug-fixes and work-arounds for problems found with versions 2.00 to 2.20. The following were included:


ENHANCEMENT HW-000422: Memory usage reduced during sample cache regeneration occasionally giving up to 48 MB more memory for samples.

Hauptwerk keeps a specially-formatted cached copy of the samples for each organ so that organs are able to load extremely rapidly. When an organ is loaded for the first time, or if its rank routing parameters are changed subsequently, or after installing any Hauptwerk upgrade, Hauptwerk needs to regenerate the sample cache. During that process, some extra memory is required to ensure that the cache is written to the hard-drive with minimal disk fragmentation (especially on Windows NTFS). Hauptwerk automatically and dynamically reduces that extra memory if the computer is running low on memory during the cache regeneration process. However, it is sometimes possible that the operating system does not allow that memory to be reallocated, giving rise to an erratic 'out of memory' memory error when very regenerating the sample cache and very close to the limit of physical memory. It has been possible to reduce the size of the extra temporary dynamic memory used by 48 MB without causing an increase in subsequent organ loading times. In cases where the operating system previously failed to reallocate this dynamic memory, up to 48 MB more memory than previously is now available for loading an organ.


ENHANCEMENT HW-000392: Installer: .dmg (disk image) format used on Mac OS X instead of .zip (Mac OS X only).

Previously Hauptwerk's installer was packaged inside a .zip archive file to provide error resilience (checksumming). However, we found the .dmg (disk image) format to provide somewhat easier verification to ensure that downloaded files or CDs are not corrupted, and so have now packaged Hauptwerk's installer in a .dmg file instead of a .zip file.


ENHANCEMENT HW-000397: Installer: extra resilience to partly-broken installations.

If a user had moved or removed some of Hauptwerk's main folders and then run Hauptwerk's installer, or if the installer had previously been cancelled or crashed during an installation or deinstallation phase, or if two instances of the installer had previously been run at the same time, the version Hauptwerk 2.20 installer would detect the partial installation and enter 'clean installation' mode instead of attempting to upgrade or repair the installation, since it would no longer have the necessary information about where the files should be installed. This caused confusion for some users who had then selected different installation folders, preventing settings and organs from the previous installation being found. The installer now only prompts for locations for any specific installation folders that are found to be missing, and gives a warning message if either of the two critical folder structures (user data, sample sets and components) is missing. Notes have also been added to the user guide that the installer should not be cancelled during an installation or deinstallation phase, and that two instances of the installer must never be allowed to run at the same time. The installer now also attempts to clean up any previous partial broken installations found.


ENHANCEMENT HW-000398: Jack OS X audio router software supported (Mac OS X only).

Jack OS X is a freeware third-party utility that allows low-latency audio to be routed in real-time between OS X applications, such as Hauptwerk and an audio sequencer or between Hauptwerk and real-time reverb processor software. Hauptwerk has been changed to be compatible with it. However, Jack OS X is quite a technical piece of software, and we think some Hauptwerk users may find it too complex to configure, so it is probably not an ideal solution for those simply wishing to apply artificial reverb to dry sample sets.


ENHANCEMENT HW-000396: Documentation: installation folder clarification.

When the 'Custom' option is selected in Hauptwerk's installer, you can select a folder for each of the types of data that Hauptwerk will create. It has been clarified as a background information note in the installation instructions in the user guide that the files and folders will actually automatically be created within a sub-folder of the selected folder.


ENHANCEMENT HW-000401: Documentation: installation note about time taken to open installer with Explorer (Windows only).

A note has been added to the installation instructions to indicate that the installer or its icon may take a while to appear when using Windows Explorer. This is not relevant on Mac OS X.


BUG HW-000404: Possible periodic audio glitches when recording output (Windows only).

Occasional glitches in the audio output could be heard in version 2.20 (only) when the output was being recorded. These usually took the form of a brief glitch lasting a few milliseconds every 20 - 90 seconds and were related to the buffering of the audio stream. They may or may not have appeared in the recorded audio, usually not. This only seems to have been a problem on Windows; it had not been found to affect Mac OS X.


BUG HW-000405: Installer: Hauptwerk 2.20 installer could cause user settings to revert to their defaults under a certain circumstance.

If you had not used Hauptwerk version 2 since the 31 October 2006 before upgrading to version 2.20, version 2.20's installer would overwrite your general settings with its defaults because the timestamp on the default settings files was 31 October and it would incorrectly overwrite the settings if its default files were more recent than those already installed. If you had already upgraded to 2.20 and had been affected by this problem and want to recover your previous settings, please contact us for instructions.


BUG HW-000412: Copy-protected sample sets would not install or load on Apple Mac G4/G5 computers using Hauptwerk 2.20 (Mac OS X only).

If you tried to install a copy-protected sample set on an Apple Mac with a G4 or G5 processor (only) using Hauptwerk version 2.20, error ERR:1223 would appear, preventing the installation from continuing. This problem did not affect Apple Macs with an Intel processor or Windows PCs.


BUG HW-000428: 'What's this' question-mark help not working on Apple G4/G5 computers using Hauptwerk 2.20 (Mac OS X only).

Each settings screen has a question mark button which is used to provide help for each setting on the screen. Clicking that button on Apple G4/G5 computers (only) caused Hauptwerk to crash.


BUG HW-000391: Installer: un-installer could freeze if installation had previously been upgraded from pre-v2.20 version (Windows only).

If you previously had a version of Hauptwerk 2 installed prior to 2.20 and then upgraded to 2.20 or later, the un-installer could freeze during the final stage when removing Windows registry entries.


BUG HW-000402: Component installer could appear to have frozen when installing very large sample sets (Windows only).

In Hauptwerk version 2.20 onwards, when you have selected a component package to install using the 'File | Install organ, sample set, temperament or impulse response' menu function, Hauptwerk's component installer first copies the whole component package file to a temporary location on your hard-disk before attempting to extract it. During this initial copying process the message 'Please wait whilst the component package is prepared for extraction' is displayed, with a progress indicator beneath it. However, with extremely large component package files of several gigabytes, the progress indicator could incorrectly stay at 0 percent throughout the whole process. Since copying a file of several gigabytes may easily take five minutes or more, it appeared that Hauptwerk had frozen. This problem was related to the way that the size of such files is reported incorrectly by some Windows functions, and the problem did not affect Mac OS X.


BUG HW-000403: VSTi: error message ERR:0813 could appear when clicking OK on audio outputs screen.

In the VSTi configuration (only) of Hauptwerk, clicking OK on the 'General settings | Audio outputs' screen could give 'ERR:0813 You have specified a value for the attribute named buffer size (sample frames), which is not allowed'.


BUG HW-000423: Component installer could be very slow in version 2.20 when installing large sample sets (Windows only).

In Hauptwerk version 2.20 onwards when you have selected a component package to install using the 'File | Install organ, sample set, temperament or impulse response' menu function, Hauptwerk's component installer first copies the whole component package file to a temporary location on your hard-disk before attempting to extract it. In version 2.20 on Windows PCs this copying process could be very slow, depending on the speed of the CD/DVD drive. The problem did not affect Mac OS X. It has been possible to speed up the copying so that sample sets now install much faster.


BUG HW-000406: Notes could stay on if a MIDI sequencer was stopped with notes sounding.

Some MIDI sequencers (notably Cakewalk Sonar) do not send individual note-off messages for any pressed keys when playback is stopped, instead sending a single 'all notes off' message. Hauptwerk versions 2.20 and below did not implement the special MIDI 'all notes off' message, so the notes could remain sounding if a MIDI sequencer was stopped while notes were sounding.


BUG HW-000409: Very occasionally virtual console display was not redrawn fully after an organ was loaded.

After loading an organ, on rare occasions the virtual console display would be only partly drawn, leaving parts of the logo screen still visible.


BUG HW-000395: Documentation/installer: installation note that dongle driver installer window can appear behind other windows (Windows only).

The driver for the USB licence dongle is automatically installed or upgraded by Hauptwerk's installer as a final installation step. On Windows PCs, if you use Alt+Tab to switch to another application during installation then you use Alt+Tab to switch back to Hauptwerk's installer, it may appear to have frozen whilst waiting for the driver to install. In fact that is not the case - the driver installer is a separate application, so you just need to switch to that to acknowledge its status message. If you do not switch applications during installation then the driver installer's window always appears on top, so it is obvious that you just need to click OK on it. This behaviour probably cannot be changed because the driver installer is a separate application, but a note to this effect has been included in the installation instructions in the user guide.


BUG HW-000407: CODM: value of 0 for Rank.WindSupply_MaxFlowRandomisationPct parameter gives error.

When using the Custom Organ Design Module (CODM) for non-pipe 'ranks' (e.g. harpsichords) one might reasonably want to disable the turbulence model by setting the WindSupply_MaxFlowRandomisationPct parameter to 0 for the Rank table. However, doing so gave error ERR:4505 when loading the compiled organ definition file.


BUG HW-000425: VSTi: recording format setting was not mandatory on audio outputs screen.

In the VSTi version (only) on the 'General settings | Audio outputs' screen the recording format setting was not mandatory, but should have been. This caused no functional problems.



Changes in version 2.20

Version 2.20 was a maintenance release, the primary focus of which was to produce a version of Hauptwerk for Apple Mac computers (both Intel and PowerPC G4/G5) running OS X 10.4 or later. However, various significant performance and usability enhancements were also included for all platforms, as well as many other minor enhancements and some bug fixes.


ENHANCEMENT HW-000093: Hauptwerk ported to Apple Mac OS X (OS X 10.4.8, Intel Macs and G4/G5 Macs).

Hauptwerk is now available for Apple Macs as well as for Windows PCs. Intel and PowerPC (G4 or later) Macs are fully supported and Mac OS X 10.4.8 or later is required. This first OS X release does not have a plug-in (Audio Unit or VSTi) version of Hauptwerk, but we hope to add that soon.

If you are planning to buy a new computer to run Hauptwerk, we now strongly recommend the Apple Mac Pros, since these offer the best performance we have yet seen with Hauptwerk, appropriate specifications are readily available pre-assembled from Apple with full hardware and software support and warantees, the Apple hardware and OS X together give absolutely robust, glitch-free, low-latency audio with superb MIDI timing, and we have found them generally much easier to install and configure than PCs. Our recommended specification for large organs is an Apple Mac Pro with 2 x 2.66 GHz processors and 4 GB of Apple memory. Please see the Crumhorn Labs website for audio and MIDI interface recommendations. An excellent 8-output firewire audio interface with one MIDI IN and one MIDI OUT port, with which we have conducted most of our testing on the Mac platform, is the Focusrite Saffire. With the Mac Pro it is easily possible to achieve a polyphony of over 4500 simultaneous pipes with all of Hauptwerk's realism feature's enabled.

Note that OS X is not yet fully 64-bit, so any one program is limited to a maximum of 4 GB of addressable memory. However, unlike 32-bit Windows (which has a limit of about 2 GB or 2.7 GB per program), the full 4 GB is available, so that is much less of an issue. Using a Mac Pro with 4 GB of memory, even the largest organs currently available for Hauptwerk (such as the Milan Digital Audio E.M. Skinner and OrganArt Media Aix) can be loaded in 16-bit, stereo with full release tails by simply enabling loss-less memory compression for all ranks in Hauptwerk (and also disabling multiple loops for the Hauptwerk.cz Litomysl). Since the Mac Pro has so much 'spare' processing power, the 10-15 percent reduction in polyphony resulting from using loss-less memory compression is no real problem.

We will, of course, continue supporting and developing for 32 and 64-bit Windows platforms with the same commitment that we have until now, but we have found the Intel Mac platform to be so good for Hauptwerk that we have decided to make this platform our primary recommendedation for new computers. The new range of Apple MacBook Pro notebooks, using the Intel Core 2 Duo processors, should also be excellent for use with Hauptwerk, although they have only one dual-core processor (whereas the Mac Pros have two) and a maximum of 3 GB of memory can be installed.

A licence for Hauptwerk version 2 is valid on any computer, Mac or PC, so there is no cross-grade cost if you wish to transfer an existing Hauptwerk licence from a PC to a Mac. The Mac and PC editions of Hauptwerk are available on separate CD media, since each requires a full CD. When ordering a CD from the Crumhorn Labs on-line shop you can simply select whether you would like a PC or Mac CD, or both.

We have tested all currently-known native Hauptwerk version 2 sample sets on the Mac platform and no problems were found. Hauptwerk version 1 sample sets can also be imported, and, once imported should work fully. However, unlike version 2, Hauptwerk version 1 did not have a native multi-platform sample set installer, so the third-party installers with which some version 1 sample sets were supplied may not work on non-Windows computers. For such version 1 sample sets you would either need to extract them temporarily to a Windows computer, and then transfer them to the Mac via CD, DVD or a network, or contact the supplier of the sample set to see if they can be supplied in a format that is readable on the Mac platform.


ENHANCEMENT HW-000175: Organ loading times massively reduced again, especially for large organs with tremulants.

The high-speed sample cache has been extended to cover other types of data, especially tremulant data, which gives an enormous reduction in loading times for large organs with many ranks affected by a tremulant. For example, the loading time from cache for the Silver Octopus 36-stop Willis Hauptwerk v2 sample set has been reduced by a staggering 85 percent, and the Milan Digital Audio Virginia WurliTzer v2 by about 59 percent. There is some benefit for smaller instruments as well; the loading time for St. Anne's has been reduced by about 15 percent. A small amount of further improvement (typically 1-4 seconds of further reduction in loading time) is likely to be possible by caching the image data, which we will also be addressing in a future relase soon.


ENHANCEMENT HW-000224: Combination files load much faster.

The time taken to load a combination file for a large organ has been massively reduced. Combination files now load almost instantaneously for most organs.


ENHANCEMENT HW-000292: Maximum polyphony increased from 4096 to 8192 for the Concert Edition.

Computers with two of the new Intel 'Core 2' Xeons (51xx series), such as the Apple Mac Pro series, can easily exceed the previous maximum Hauptwerk polyphony of 4096, hence we have increased the maximum polyphony to 8192 in the Concert Edition. The maximum polyphony remains at 1024 in the Studio Edition. For example, 32-bit Hauptwerk with all realism features enabled can safely achieve a polyphony in the region of 4600 simultaneous pipes on a Mac Pro with 32-bit Mac OS X 10.4.8 ('Tiger'). We anticipate that much higher polyphony still will be possible with 64-bit Hauptwerk. (Note that full 64-bit support does not yet exist in OS X, and is expected in the next version of OS X, early in 2007).


ENHANCEMENT HW-000304: All audio output configuration settings redesigned for ease of use.

We have reviewed and redesigned all of the audio output configuration screens and settings with a view to making them as easy, quick and convenient to use as possible, whilst not losing any of their flexibility. We have moved as many settings as possible to the 'General settings | Audio outputs' screen, so that all standard stereo audio configuration (e.g. for the Studio Edition) can be performed from just that one screen, including device selection, device channel selection, output levels and buffer sizes. The 'General settings | General options | Audio output' screen tab has thus been eliminated, as has the 'General settings | Audio output channels' screen. On Windows platforms, both ASIO and DirectSound drivers are now always available for selection, eliminating the global driver type setting. For multi-channel audio (Concert Edition only), ASIO and DirectSound drivers can now be used simultaneously, with accurate synchronisation being maintained between them. Concise 'tool tips', aimed at novice users, have been added to the 'General settings | Audio outputs' screen, and will be added to other screens in future releases. The buffer size setting now also affects ASIO drivers, allowing the 'General settings | Adjust ASIO settings for current audio device' menu function to be removed. All previous user configuration is automatically migrated with the exception of the ASIO buffer size, which is re-defaulted to 1024 sample frames. IMPORTANT: You may thus wish to review the buffer size after upgrading if you are using an ASIO driver.


ENHANCEMENT HW-000004: Screen position of main window now remembered and restored automatically; no longer re-centres.

Previously the main window was automatically re-centred on the screen whenever any system function was selected. Many system functions do not need to re-size the window (e.g. entering or leaving capture mode), and these no longer affect the window position. Instead of centreing the window on the screen, Hauptwerk now stores your previous window position and automatically restores the window to that position when you load Hauptwerk or load/activate or unload/deactivate an organ. The window position is stored separately for each organ, allowing the window to be positioned optimally for multi-monitor and touch-screen configurations.


ENHANCEMENT HW-000108: Additional multi-channel audio output allocation algorithms included, such as C/C# split with two mono channels (Concert Edition only).

The channel allocation algorithm, selected for an audio output group, determines the rules used to route each pipe in a rank to individual mono or stereo physical audio outputs. Three new channel allocation algorithms have been added: 1. Cyclic allocation within each octave, constant for each octave; 2. Cyclic allocation within each octave, with octaves and ranks cyclic (effectively minimises the chance of any two pipes of a