How to Use Hauptwerk Sample Sets in GrandOrgue
Every week, someone searching for free Hauptwerk sample sets discovers GrandOrgue and asks the obvious question: can I play those Hauptwerk sets in GrandOrgue? The official answer comes straight from the GrandOrgue project’s own FAQ on GitHub: GrandOrgue cannot load a Hauptwerk sample set directly — but if the samples are not encrypted, you can add a GrandOrgue-style ODF for the set and open it with GrandOrgue. Here is what that means in practice, which sets qualify, and which ones are a dead end.
Why “Directly” Does Not Work
A sample set is two things: the audio samples (the recorded pipes) and the organ definition file (ODF) that describes the organ — which samples belong to which stops, how the windchests and keyboards relate, the couplers, the tremulants. Hauptwerk and GrandOrgue use incompatible ODF formats. The samples themselves are usually plain .wav files both programs can play, but without a GrandOrgue-format ODF, GrandOrgue has no idea what to do with them.
So the task is never “convert the samples”. The samples are fine. The task is getting a GrandOrgue-style ODF for them.
Which Sets Can Be Converted — and Which Cannot
This is the part to get right, because it saves you hours:
- Can be converted: older, unencrypted sets — typically Hauptwerk v1-era free sets whose samples are plain
.wavfiles and whose definition is an accessible XML file. Many early free instruments fall into this category. - Cannot be converted, ever: sets with encrypted samples (the
.hbw/.hbxformats) or hardware-dongle/iLok protection. The encryption exists precisely to prevent this, and for legal reasons only Hauptwerk may use those formats. Do not waste time trying.
The Sonus Paradisi case
Sonus Paradisi makes some of the most admired sample sets available, and their full commercial versions are encrypted — they cannot be used in GrandOrgue, full stop. This is worth stating plainly because it is the most common disappointment. A few of their free demo volumes have circulated with community-made GrandOrgue ODFs, but the paid encrypted sets are off limits. For the full story, see our page on Sonus Paradisi and GrandOrgue.
The Two Official Routes to a GrandOrgue ODF
The GitHub FAQ names exactly two options:
Option 1: Find an existing GrandOrgue ODF
Over the years, community members have written GrandOrgue ODFs for a number of unencrypted Hauptwerk sets and shared them. The project’s wiki maintains a sample sets page with links. Searching the web for the set name plus “GrandOrgue ODF” is often faster than converting anything yourself.
Option 2: Convert the Hauptwerk definition with OdfEdit 2.0
OdfEdit is a Python 3-based GUI tool, referenced in the official FAQ, that converts a Hauptwerk-style definition file into GrandOrgue format. The rough workflow:
- Install Python 3 and OdfEdit.
- Load the unencrypted Hauptwerk definition (XML) of the set.
- Run the conversion, which produces a GrandOrgue
.organfile pointing at the existing samples. - Open the resulting
.organfile in GrandOrgue and check every division.
If you prefer building ODFs graphically rather than converting, GoOdf is a fully GUI-based alternative for creating and editing ODFs without hand-editing the .organ text — also mentioned in the FAQ. For background on what an ODF actually is, see what is an ODF?
Common Conversion Pitfalls
Converted sets usually work, but rarely perfectly on the first try. The issues the community reports most often:
- Release samples misbehaving. Release markers and cue points do not always translate cleanly; notes may cut off oddly or releases may sound too long. This is the number one thing to check after converting.
- Volume balance between ranks. A stop that sat perfectly in Hauptwerk may come out too loud or too quiet in GrandOrgue. Expect to adjust rank gains in the ODF.
- Missing features. Anything the original set did that has no GrandOrgue equivalent (or that the converter does not handle) will be silently dropped — always compare against the original’s stop list.
- Temperament and tuning quirks. Verify octaves and tuning across the compass; small errors are common and need manual checking pipe by pipe for critical work.
Start With Sets Made for GrandOrgue
Honest advice: converting is a project, not a shortcut. If you just want to play, start with the many excellent sets built natively for GrandOrgue — including 14 free instruments from Piotr Grabowski and the community sets in our sample set library. Our roundup of the best free GrandOrgue sample sets is the fastest path to music. Come back to conversion when there is a specific unencrypted instrument you cannot live without.
FAQ
Can GrandOrgue open a Hauptwerk .organ file?
No. Despite the similar name, GrandOrgue .organ files and Hauptwerk definitions are different formats. GrandOrgue cannot load a Hauptwerk sample set directly — you need a GrandOrgue-style ODF for the same samples.
Are encrypted Hauptwerk sets usable in GrandOrgue?
No. Encrypted sample formats (.hbw/.hbx) and dongle-protected sets cannot be converted or loaded. This is both a technical and a legal barrier.
Is converting a sample set legal?
Converting an ODF you have legitimate access to, for your own use, from unencrypted samples, is generally accepted in the community — but always respect the sample set’s license. Do not redistribute converted sets without the producer’s permission.
What is OdfEdit?
A Python 3-based graphical tool for editing organ definition files, including converting Hauptwerk-style definitions to GrandOrgue format. It is referenced in the official GrandOrgue FAQ.