Skip to content
View in the app

A better way to browse. Learn more.

Learn more

OMN Engraver

OMN Engraver

OMN Engraver displays music written in OMN (Opusmodus Notation), from a short snippet to a complete ensemble score. Use it to inspect notation, compare concert and written pitches, hear the music, prepare individual parts, and print or export the result.

The music comes from your OMN expressions and def-score definitions. Edit the musical source in the Workspace, then update its engraving in this window.

The controls described here apply to OMN Engraver on macOS and Windows.

To arrange notation alongside documents or graphs, see Tabs and Layouts for mixed tab types, dragging between windows and panes, layout presets, Move Pane commands and worked examples.

Open a score

Evaluate your musical material and its def-score, then use the normal Notation command or call display-score with the score name.

(def-score engraver-study
    (:title "Engraver Study"
     :composer "Opusmodus"
     :key-signature 'chromatic
     :time-signature '(4 4)
     :tempo 72
     :layout (piano-layout 'rh 'lh))
  (rh :omn '((q c5 p leg d5 e5 g5)
             (h f5 e5))
      :channel 1 :sound 'gm :program 0)
  (lh :omn '((h c3 g3)
             (w c3))
      :channel 2 :sound 'gm :program 0))

(display-score 'engraver-study)

display-score normally reuses the open engraving window. Add :new-window t to keep another score alongside it.

(display-score 'engraver-study :new-window t)

The window label identifies the score and its generation index, for example la-marangona [2]. The title printed above the music comes from the score’s :title setting.

A ps preview with :title uses that title in the window bar and Grid history, with one generation index: for example, OMN Engraver: Maderna and Mascagni Paths [7]. MusicXML imports likewise use their imported title when present; otherwise the filename supplies the label.

Display a snippet

Select an OMN expression or a variable containing OMN and use Notation. Use Multiple Voices for material that should appear as separate voices. The same viewing, playback, saving and printing controls are available for snippets and named scores.

'(e c5 p leg d5 e5 f5 g5 a5 g5 c6)

A snippet occupies a complete sheet in Page View. This leaves room for a title and other credits when preparing a print copy.

The window

image.jpeg

The score fills the main viewing area. Play, Rewind and the three readouts—Bar, Bars and Page—stay at the top. The right-hand Inspector contains View, Page Layout, Score Details and Playback. Refresh, Save PDF… and the status line remain at its bottom.

Drag the vertical divider to change the Inspector width. Long settings scroll inside the Inspector. Use the Inspector icon at the top right to hide or show the Inspector. While it is open, View stays visible; the chevrons to the left of the other headings open or close their sections. The Inspector width and section states are remembered. The images show macOS; the same controls are available on Windows. Illustrated values are examples, not defaults.

Playback and readouts

Play starts the displayed music and changes to Pause. Click again to pause or resume. Rewind returns to the beginning; if playback is running, it continues from there. Click the notation to move the playback position. Opening a score does not start playback unless display-score was called with :auto-play t.

The three readouts after Rewind show:

| Readout | Meaning |
| Bar 1, for example | The written bar number at the current playback position. This follows playback independently of the page you are viewing. |
| Bars 1–25, for example | The range of written bars on the displayed printed page. |
| Page 1 / 8, for example | The displayed printed page and total page count. |

The same three readouts appear in standalone windows, tabs and layout panes. For elapsed time, detailed bar/beat position and tempo, use the Workspace Meter.

In Gallery View, the bar range and page number still refer to the corresponding printed page, not to the number of horizontal screenfuls. The readouts are indicators, not buttons.

View

image.jpeg

| Control | Action |
| Fit Width | Fit the page width to the available score area and update the Zoom value. |
| Page View / Gallery View | Choose paginated sheets or the horizontal score view. |
| All instruments | Show the complete score or select an individual instrument. |
| Concert Pitch / Transposed Pitch | Choose sounding-pitch or instrument-transposed notation. |
| Zoom | Change screen magnification without changing the printed notation size or page breaks. |
| Page Colour | Choose a paper colour for viewing. PDF and printing retain white paper. |
| Bar numbers | Show or hide interior bar numbers. System-start numbers remain visible. |

Page Colour offers White, Pale Yellow, Light Cream, Ivory, Warm Ivory, Warm Sand, Pearl Grey and Soft Grey. It is independent of the application’s light or dark appearance.

Page View and Gallery View

Page View displays sheets in the chosen paper format. Scroll vertically to inspect pagination, headings and page turns.

Gallery View presents the music as a long horizontal system. With Follow Playhead enabled, it advances in stationary screenfuls. The grey reminders at the left retain instrument labels, grouping, clefs, key and time signatures, and tempo while the music moves through the view.

image.jpeg

The illustration shows the Inspector hidden to give the music more width. Bar 50 is the playback position; Bars 47–51 and Page 4 / 8 identify the corresponding printed page.

Use Left/Right or Page Up/Page Down with the score focused to browse Gallery View. Its contextual menu also offers Previous Gallery Page and Next Gallery Page. Browsing does not move the playback position. Screenfuls depend on width and zoom; PDF and printing still use the paginated layout.

Instrument abbreviations follow the layout catalogue; supplied non-empty abbreviations take precedence. See OMN Instrument Abbreviations for the list.

Individual instruments and transposed parts

Choose an instrument from All instruments to display and play its part. Keyboard staves stay together where appropriate. The selection stops and rewinds playback; returning to All instruments restores the ensemble. Consecutive complete empty bars in a part can appear as multibar rests.

image.jpeg

Concert Pitch shows concert pitches, retaining conventional octave notation for octave-transposing instruments. Transposed Pitch shows the instrument’s written pitches and key signatures. This changes the notation, not the sounding pitches. The image shows Violin II selected from the instrument menu, with Concert Pitch and Light Cream paper. PDF, printing and score exports use the current instrument selection.

Page Layout

image.jpeg

Paper format offers A3, B4 and A4 in Portrait or Landscape. Notation size changes the physical size of the staves and notation and lays out the retained music again. Zoom changes only screen magnification. For example, a 20 pt score viewed at 104% remains 20 pt in the PDF. Initial settings are A3 Portrait and 24 pt when no preferences have been saved; later choices are remembered.

Enter starting bar numbers in Start systems at bars and Start pages at bars. In a score with at least seven bars, for example, enter 3 7 in the first field and 5 in the second. Parenthesized lists such as (3 7) are also accepted. These fields do not need an apostrophe.

The numbers mean start before these written bars, not bars per line. A page start also begins a system. Leave a field empty for automatic breaks of that kind. Press Return or click Refresh to apply typed changes. The engraver may add more breaks when the music needs space. These settings apply to Page View, PDF and printing; Gallery View uses width and zoom for its screenfuls.

System dividers controls the paired diagonal marks between systems on a page. Dividers: Auto adds them to large instrumental scores. Choose Dividers: Left or Dividers: Both to enable them explicitly, including for smaller ensembles; Dividers: Off omits them. The marks separate systems, not staves. Paper, planned breaks and divider controls are unavailable in Gallery View.

Page and notation-size changes reuse the displayed musical result and do not rerun random generators. If a complete system is too tall for the sheet, the engraver can reduce its effective size to fit; the status line reports that fitted size.

The same break requests can be kept in source code:

(display-score 'engraver-study
               :page :a3-landscape :size 20
               :system-breaks '(2) :page-breaks nil)

Choose bar numbers that exist in your score. See display-score for written-bar numbering, repeats and excerpts.

Score Details

image.jpeg

Prepare the printed heading and credits directly in the Inspector:

| Field | Content |
| Title | Main title above the music. |
| Subtitle | Additional heading text. |
| Composer | Composer credit. |
| Lyricist / text author | Text-author credit; not lyrics attached to individual notes. |
| Note | A notice above the copyright line. |
| Copyright | Copyright statement. |

Apply typed changes with Return or Refresh; multiline fields allow several lines. The status “Settings changed · press Return or Refresh” identifies pending edits. These settings affect the displayed score and its output and are retained with the view. They do not edit the original Workspace source. Keep the corresponding def-score fields in your composition when those credits should also be part of its source.

Playback

image.jpeg

Follow Playhead keeps the red playback cursor visible. Turn it off to browse another passage while listening. GM / Ports chooses internal General MIDI or the score’s assigned MIDI destinations when both are available. A GM-only score shows a dimmed GMcontrol. The Play/Pause and Rewind buttons remain above the music.

Refresh and recovered scores

After changing musical source, evaluate the changed expressions and score definition, then click Refresh. Refresh reads the latest evaluated definition; it does not evaluate the source file. If Inspector settings are pending, Refresh first applies them to the retained music; click Refresh again to load a newly evaluated definition. For snippets and recovered session entries, Refresh rebuilds the retained musical result.

image.jpeg

After restarting Opusmodus, a recovered score can show “Click Refresh to display the score” with a large Refresh button. Click it, or press Return while the score area is focused, to build its notation. Once ready, Return returns to its normal Rewind action. This pending state differs from No Score, when no score is selected.

The bottom status line reports pending edits, rendering, page/voice counts and errors. If a refresh fails, the last successful drawing remains available. For a new random result, evaluate the generator again in the Workspace; changing view settings alone keeps the current music.

Save a PDF or print

  1. Choose All instruments or the part you want to output.

  2. Use Page Layout to set paper format, notation size and any planned breaks.

  3. Complete Score Details and apply your edits with Refresh.

  4. Click Save PDF… at the bottom of the Inspector and choose a filename and location.

Save PDF writes the paginated score directly, without going through the print dialog. It uses the current instrument selection, layout, credits and bar-number setting. Pending Inspector changes are applied before export. Gallery View exports the corresponding printed pages. Screen zoom, the red playhead and the grey Gallery reminders are excluded; paper is white regardless of Page Colour.

For a physical printout, use Print… in the contextual menu or File > Print. The print workflow lets you choose the printer, page range and copies. Match the printer paper to the engraving’s format. Saving a PDF or printing does not change your musical source.

The contextual menu

image.jpeg

Right-click the music for view, save, export and print commands. Refresh and Fit Width are also available here. In Gallery View, the menu adds the horizontal navigation commands. On macOS, system items such as AutoFill may also appear.

Import MusicXML

Open a .xml, .musicxml or compressed .mxl file with File > Open, drag it into OMN Engraver, or pass its pathname to display-score. A small Please wait… window reports reading and engraving while the work runs in the background. Cancel, Escape or closing this window stops the request and keeps the currently displayed score; no new score is shown or played.

The imported heading uses the MusicXML work title, or the movement title when no work title is supplied. A distinct movement title becomes the subtitle. Composer, lyricist and copyright credits are retained when present. Explicitly labelled MusicXML title, subtitle and creator credits provide fallbacks when the corresponding metadata is absent.

Save and export

The Grid menu at the upper left opens the score history and the saving commands. Save to OMN Score… and Export to MusicXML… are also available in the contextual menu.

| Command | Result |
| Save to OMN Score… | Saves an editable .opmo score definition. Use it to keep a snippet or the currently selected part as an OMN score. |
| Export to MusicXML… | Saves a .musicxml or .xml file for use in another notation application. |
| Export to Editor | Opens the selected score or snippet in your configured external notation editor using musicxml-to-editor. |
| Print… | Opens the print preview and printer workflow, including PDF output where provided by the operating system. |

File > Export > Last Score to Editor, immediately after Revert, sends the last compiled score to your configured external notation editor using musicxml-to-editor. It is available once a score has been compiled, including when OMN Engraver cannot display it.

To export code directly, choose Tools > Snippet > Snippet to Editor (Cmd-= on macOS, Ctrl-= on Windows). This uses snippet-to-editor with the selected OMN, variable or expression.

Each send to an external editor creates a uniquely named snapshot in the Editor Exports subfolder of your MusicXML output folder. Earlier exports remain unchanged, so a new send does not overwrite a file already opened by the editor.

File > Save As… also saves an OMN score. The Grid saving and export commands use the selected history item in this window.

To bring MusicXML into OMN Engraver, use File > Open, drag a MusicXML file onto the window, or supply its pathname to display-score. Plain MusicXML and compressed .mxl files are supported.

History and remembered settings

Use the Grid menu to return to a recent score, or the Back and Forward arrows to move through the window’s history. Each entry retains its own viewing state. The + button clones the current view into another window; × removes the current history entry.

Automatic session recovery

OMN Engraver automatically keeps temporary OMN session copies of the evaluated scores and snippets you display. Each displayed version has its own entry in Grid, preserving the exact musical result, including randomly generated material. The captured score includes its OMN music, custom text and program attributes, instrument and MIDI settings, titles, tempo, metre and layout choices. The music is captured before engraving begins.

When you restart Opusmodus, the saved entries return to Grid. The original composition does not need to be evaluated again, and imported MusicXML does not need to be converted again. Session entries load as musical data first; notation is rebuilt when needed, keeping startup responsive.

| Action | Session behaviour |
| Refresh on a recovered score | Rebuilds notation from the saved OMN using the selected page format and notation size. The original score definition is not required. |
| Play | Prepares the recovered score for playback, rebuilding notation first if needed. Recovery itself never starts playback. |
| Quit Opusmodus | Keeps the session scores for the next launch, including the versions available in Grid. |
| Remove a score with ×, or close its last window | Deletes that score’s temporary session copy. Other session scores remain available. |
| Save to OMN Score… | Creates a permanent, editable .opmo score from the selected score’s latest temporary snapshot. |
| Export to MusicXML… | Creates a permanent MusicXML file from the same selected snapshot. |
| Export to Editor | Opens the selected score or snippet in your configured external notation editor using musicxml-to-editor. |

OMN Engraver also remembers the score’s page format, notation size, zoom, view mode, bar-number setting, Follow Playhead setting and viewing position. A recovered entry shows Recovered score · press Refresh until its notation is prepared.

When no score is open, the centre of the viewing area shows No Score, in the same style as the MIDI Player. A recovered score shows Click Refresh to display the score until its notation is ready.

Temporary session copies are maintained automatically. Permanent OMN scores and MusicXML exports remain on disk when a session score is closed. Continue saving your composition source in the Workspace as usual: the session captures the evaluated musical result, including snippets whose source was only entered in the Listener.

Keyboard controls

With the score area focused:

| Key | Action |
| Space | Play or pause. |
| Escape | Stop playback. |
| Return / Enter / Home | Rewind. Return also activates Refresh for a recovered score waiting to be drawn. |
| Left / Page Up | Previous screenful in Gallery View. |
| Right / Page Down | Next screenful in Gallery View. |

In an Inspector text field, Return applies the typed settings instead. Keyboard actions follow the focused area.

Related document

OMN Articulation Listing describes articulation symbols, playing techniques, ornaments and other OMN attributes, with their exact names and short explanations.

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.