Write¶

Write is the editor where you write scores in neumaRk, with the score preview updating in real time as you type.

The three actors not to confuse¶

To use Write with peace of mind it helps to keep in mind who does what. These are three different things:

	What it is	What it does
neumaRk (NRK)	the language: the text you write is the song	persists, independent of the app
the editor	the writing environment	colours the text, flags errors in the console, explains via the `?` help; leaves your text exactly as you typed it
Speedy Entry	the typing assistant	transforms what you type as you type (automatic spaces, `Tab` closes the measure…); it's optional and turns off with one click

Speedy Entry only produces ordinary NRK — the same text you could type by hand. If it gets in your way, turn it off from the toolbar and keep typing; your song stays as it is. Details in Speedy Entry.

The screen¶

Write is split in two halves: on the left the editor where you write the NRK text, on the right the score preview. Above the editor there's a toolbar; at the top of the page the topbar with the file menu and the song title. The console appears at the bottom when needed.

Command	What it does
Title · Key · Meter	clicking them opens the Document properties (edit title, author, key, tempo, meter without writing in the text)
▶ Play	plays the melody; long-press to open the playback controls panel
EXTEND / COMPACT	two textual transformations of the source (see below); long-press for the options
Speedy Entry	turns the assistant on/off (long-press for the settings)
`?` Help	opens the neumaRk help panel (also `F1`)
Console	opens/closes the processing console

The editor¶

The editor highlights the syntax, links text and score (hovering a measure highlights it on both sides) and lets you select measures. Right-clicking a measure opens a context menu: cut/copy/paste, insert, delete, transpose, isolate into a new row, move to the previous/next row, merge into one.

Selection modifiers: Shift extends the text selection, Cmd/Ctrl+Shift extends the measure selection.

The score preview¶

It updates on every change. From its menu you adjust rendering settings, fit, zoom, density, page/papyrus, and start the PDF export.

EXTEND and COMPACT¶

The same song can be written in two textual forms, and these two buttons convert the source from one to the other:

COMPACT — uses duration and octave inheritance to remove repetition (shorter text, quick to type by hand).
EXTEND — makes everything explicit on every note (easier to read at a glance).

Same notes, same score: only the look of the text changes. From the EXTEND/COMPACT options menu you choose precisely which details to expand or compact (row markers, durations, pitches, shorthands, flow signs, chords), with None / Default / All presets.

Playing¶

The Play button plays the melody. Long-pressing it opens the playback controls panel: play/pause/stop and back-to-start, speed (0.5×–2×), swing (ratio and offbeat accent), count-in and the volumes.

The processing console¶

As you write, the console shows any warnings (W…, non-blocking) and errors (E…, blocking). It opens on its own when needed and closes as soon as you fix the issue; you can also keep it open by clicking its icon. Click a message to jump to the line it refers to — the console only points you to what to review.

The `?` help¶

The ? panel (also F1) is the quick reference to neumaRk: searchable, organised by topic (notes, chords, repeats, articulations, dynamics, lyrics, voices, versions…). For the full reference there's the language documentation on neumark.dev.

From the topbar:

New — a new empty document.
Open… — open one of your songs (with search by name, title and credits).
Import — import a .nrk or XML (MusicXML) file.
Export — export the song as a .nrk file (XML/Lilypond export coming).
Save (Cmd/Ctrl+S) — remember there is no overwrite: every save adds a version to your song. It works offline too (saves locally and syncs as soon as you're back online; an indicator shows the sync status).
Save as new — creates a new song from the current one (useful to start from someone else's song or to make a variant).
Revert to saved — discards local changes and reloads the last saved version.
Manage document… — rename the document (creator only, online), manage the tags, see role/dates, open in Library or delete the document (with all its versions).
Tutorial… and Guided tour — see below.

Versions and Release¶

A song evolves through versions (every save adds one). From the topbar you see the current version and its wip / stable states, you can review previous versions and make a Release: it creates a new stable version and permanently deletes the intermediate work in progress ones.

Generate a fly link (self-contained) and open the song in View. You can transpose the song from the dedicated dialog (notes, chords or both). The kinds of link and their implications are in Links & sharing.

Reactive mode and Lead¶

Opening a reactive link puts Write in linked, read-only mode: it follows the edits of whoever holds the lead in real time. Whoever has edit rights can take the Lead (take lead): from then on, each of their saves appears in real time to those watching in View; release hands the lead back. This is the basis of real-time rehearsals and lessons (see the reactive link in Links & sharing).

Built-in tutorials¶

From the file menu you open the step-by-step tutorials (chosen from a list, with a step count): at the top appear the back / forward / reset step controls. There's also a guided tour of the interface (driver.js), started from the logo at the top left.