Hauptwerk organ usage

Occasionally we are contacted by the users of Hauptwerk organs to help support and configure touch monitors that are used with these systems. Hauptwerk is developed by and is a trademark of Milan Digital Audio, LLC.

Thus far the request to assist has always been with systems that utilise two touch screen monitors and are typically positioned either side of the main keyboards, as per these examples:

In the above examples two standing monitors are working in standard landscape mode with 0 degrees rotation.
In this example the two monitors are attached to a side mount arms with the left rotated 90 degrees anti-clockwise
and the right rotated 90 degress clockwise both set to run in portrait mode.

These systems use MacOS and not all organist are familiar with this operating system and installing touchscreen software and configuring two monitors often leads to a protracted email exchange which does not always result in a working touch interface which of course can be frustrating for both parties.

These notes are here to cover the main issues when using our touch screen software in these systems.


A touch screen monitor is actually two devices. The video display and a touchscreen that is placed over the front of a video display and nearly all touchscreens on modern external touch screen monitors are USB devices.  The video cable is just the video display. For touch to work you must have the touchscreen cable, normally USB, also plugged into the Mac.

With both monitors plugged into the system you can see the monitor layout and their orientation via the System Preferences (this is only showing the video/display layout and is nothing to do with the touchscreens):

 Shows information about the two connected displays For each display shows the video rotation - in this case the
display is in landscape mode with 0 degree rotation 
Shows the video arrangement, in this case, as expected side
by side, preferable with the left monitor on the left!

As with all Operating Systems you can view system information and the system's hardware components. In MacOS you can easily view the USB devices via the System Report as described here. The link shows you how to view the USB devices but also shows you the USB Vendor id (the unique manufacturer id of the device) and its Product id. With two touchscreens plugged in you would expect to see two touch devices listed.

It is important to understand that the touch software we deliver will be configured to work with the touchscreens vendor ids. If this is not the same as the one listed in the System Report then of course our software will not find the touch device and will not work. For this reason you cannot just install UPDD that may have been supplied by another Hauptwerk user and expect it to work as it is likely configured for different touch hardware.

Software delivery

Our touch screen software, known as UPDD, is delivered as a standard MacOS compressed installation file as a hyperlink in the body of an email. You click on the hyperlink and it will download the file via your default browser. The standard browser for MacOS being Safari unless you have configured the system to default to a different 3rd party browser such as Chrome. Safari will show the download in progress. This image has been taken from this Apple support article:

Once it is downloaded you can click on the updd.dmg file to install the software as described in our Quick Installation Guide.

The software is now installed and you should see the driver's daemon menu bar icon in the Menu Bar.

Configuring the touch devices

If the software is configured to support your specific touch devices then the UPDD status screen will show that the driver has located the touch devices:
(Prior to being correctly configured both touchscreens will be associated with monitor 1 whereas the screen shot below is post configuration whereby the touch devices have been associated with the individual displays)

If no devices are listed then you need to run UPDD Diagnostics (by clicking on the 'Diagnostics...' button shown above) and send us the resultant file.

If the expected devices are listed then you need to associate each touchscreen with the correct display so that the 'click' occurs on the correct video when touched.

This association is made using our Configure utility.

This will place a central cross on each monitor. You touch the cross on each touch monitor in turn. If you have any non touch screen monitors connected just click 'Next' to move on to the next display.

The configuration process may also invoke a 4 point calibration procedure if the position of the touch co-ordinates on the center cross are not as expected.

After running configuration the status screen should now show the correct monitor/touch screen association. Now when you touch the screen the point of touch should occur on the correct monitor.

If the calibration procedure was not invoked and yet calibration is inaccurate run configure again. This time it will also invoke the full calibration procedure.


In all cases if you have any issues you should run Diagnostics and send us the resultant file.

Using these UPDD terminal commands may help identify any issue you are experiencing. The terminal utility can be located in the Utilites folder as described here.

Running upddutils monitors will list the monitors seen by UPDD. This is useful to ensure UPDD is seeing the connected monitors.

Running upddutils devices will list the USB devices seen by UPDD. This is useful to confirm UPDD is seeing the touch screen USB devices as listed in the System Report.

Running upddutils pnpinfo will list the USB devices supported by the delivered software. The listed vendor and product id must match the vendor and product id of the touchscreens as shown in the System Report, USB branch.


Milan Digital Audio, LLC   Owner and developer of the Hauptwerk brand 
Martin Digital Organs  USA Builder and supplier of digital organs 
Romsey OrganWorks  UK Supplier and builder of organ consoles