User guide

Bringing in printed music (scanning)

Turn a printed hymn or PDF into MusicXML with Audiveris, then open and check it in Mizmor Studio.

Prepare a clear scan

Choose Worship › Scan printed music… for the Audiveris download links and the steps below. Audiveris is a separate, free, open-source program for Windows, Mac, and Linux. Mizmor Studio does not read a printed page or PDF directly; its scanning guide is available on every plan.

Scan at 300 dpi in grayscale, or 400 dpi for small print. Keep the page flat and straight, without a shadow along the spine. A scanner usually gives a better result than a phone photo. Audiveris accepts PDF, TIFF, PNG, and JPG input. Only scan music you may copy: your own work, public-domain music, or material your licence covers.

Turn the page into MusicXML

  1. In Audiveris, choose File › Input and open the scan.
  2. Choose Book › Transcribe book to read its pages.
  3. Choose Book › Export book. The resulting .mxl MusicXML file is saved beside the scan.
  4. Return to Mizmor Studio and click Open the .mxl file… in Scan printed music…. You can also use the editor's Open.

If the imported MusicXML identifies a scanning program as its source, the checking dialog opens automatically. The dialog is a guide; it does not save the imported score for you.

Check and correct the score

The dialog lists bars whose notes and rests do not fill the bar, or add up to too much for it. Click a listed item to jump to that note or bar. Any imported MusicXML with such bars is flagged when opened. Check these places against the printed source; a missing rest or dot, or an extra note, can change the timing.

Then look through the whole score and play it. Check the key and time signature, ties that may have become slurs, dots, triplets, accidentals, and which verse each line of words belongs to. Correct the score and save an editable copy when it is ready.

For other MusicXML imports, see Import and export.