Export

Saving to .omr file

From the input image, the Audiveris OMR engine has gradually built specific information that we collectively refer to as “OMR data”.

The reference chapter on .omr files describes thoroughly how this OMR data is organized. For now, it is enough to know that we can save (and reload) this OMR information to/from disk (into a .omr file).

Saving can be done via the pull-down menu Book → Save book or via the Ctrl+S shortcut (Command+S for macOS):

In our “chula” example, this will result in a chula.omr file.

Saving the OMR job is not strictly necessary for our very small example.

It is important to know that Audiveris can always restart from a saved .omr file, even from very old files, which allows to resume processing and user editing where they were stopped.

For sizable OMR jobs, this capability is essential.

Exporting to .mxl file

Right now, we are focused only on how to feed a music sequencer with music data it can easily import. And as of this writing, this is achieved by going through the de facto standard of MusicXML-formatted data.

This can be done via the pull-down menu Book → Export book:

From our “chula” example, this command produces a file named chula.mxl (the .mxl extension indicates a compressed MusicXML format).

Output location

Starting with the 5.4 release, the default policy is to put any output file next to the input file.

This default policy can be changed via the Preferences dialog.

We can also use the “Save book as” or the “Export book as” menu items to choose a specific output location and name.

.omr files vs. .mxl files

These files are not equivalent.

The export from OMR to MusicXML is lossy, since a large amount of OMR information can’t go into MusicXML.
A .omr file can always be used to regenerate the .mxl export, but the reverse is not true.

A good advice is to keep these .omr files – unless we are running out of disk space! :-) – because they represent a valuable source of OMR information, suitable for training newer versions of Audiveris (more on this later).