mei-friend Cheat Sheet

Navigating through notation

Select next note, rest, or mRest
Select previous note, rest, or mRest
Select note, rest, or mRest one layer up
Select note, rest, or mRest one layer down
Select note, rest, mRest in next measure
Selected note, rest, mRest in previous measure
Go to next page (or or SPACE)
Go to previous page (or or SPACE)
Go to first page (or END)
Go to last page (or HOME)

Zooming/Display

+, Zoom notation in/out (or Mouse wheel)
0, 5 Zoom to 100%, 50%, respectively

Selecting elements

click Select multiple notes by mouse click
click Select the chord when clicking onto a note

Manipulating elements

X Invert att.placement (dir, dynam, trill, tuplet number, ...), att.curvature (slur, tie, ...), att.stems (note, chord) from above to below or below to above for selected element
V Insert vertical group (@vgrp) attribute to selected elements

Moving elements

Move note, rest, mRest, multiRest one tone upwards
Move note, rest, mRest, multiRest one tone downwards
Move note, rest, mRest, multiRest one octave upwards
Move note, rest, mRest, multiRest one octave downwards
Move note, rest, mRest, multiRest one staff downwards
Move note, rest, mRest, multiRest one staff upwards

Deleting elements

BACKSPACE or DELETE Delete control elements, clef change, accid, artic, beam

MEI encoding manipulation

Renumber measures (counts successive measures with @metcon="false" as one, counts multiple endings with same numbering)
R Test renumbering (output to console)
R Execute renumbering
C Remove @accid.ges when @accid is present

Inserting elements

Key bindings insert elements above selected note by default and below when pressing the CTRL ⌃ key additionally. The elements are inserted using @startid and @endid attributes.

T Insert tempo above selected note(s)
I Insert directive above selected note(s)
D Insert dynamics above selected note, with extender if two notes selected
S Insert slur starting/ending on selected notes
T Insert tie starting/ending on selected notes
H Insert crescendo hairpin starting/ending above selected notes
H Insert diminuendo hairpin starting/ending above selected notes
B Insert beam on selected notes/chords sharing identical parent
B Insert beamSpan element on selected elements
U Surround selected elements with a supplied element; responsibility attribute to be selected in settings
A Insert arpeggio for selected note(s)
F Insert fermata above selected note
G Insert glissando starting at first, ending at last selected note
P Insert pedal down for selected note(s)
P Insert pedal up for selected note(s)
L Insert trill to selected note(s)
N Insert turn to selected note(s) (with SHIFT: lower form)
M Insert mordent to selected note(s) (with SHIFT: upper form)
O Insert octave shift above (8va), spanning two selected notes/chords (below with CTRL)
O Insert octave shift above (15va), spanning two selected notes/chords (below with CTRL)
G Insert G clef before selected element
G Insert G clef after selected element
F Insert F clef before selected element
F Insert F clef after selected element
C Insert C clef before selected element

Toggle articulation

S Toggle staccato on note/chord
V Toggle accent on note/chord
N Toggle tenuto on note/chord
O Toggle marcato on note/chord
I Toggle staccatissimo on note/chord
P Toggle spiccato on note/chord

URL Parameters

mei-friend may ba called with several parameters passed through the URL in the form of https://mei-friend.mdw.ac.at/?file=fileURL&select=beamId.

file=fileURL Open specified file URL
orientation=top|right|bottom|left Set relative position of notation in window
scale=number Specify scaling of notation (default: 55; min: 10; max: 200)
breaks=none|line|encoded|auto Specify breaks option of Verovio
select=n1,n2,n3&
select=ch1&
select=slur1
Specify selected elements (pass multiple comma-separated xml:ids and/or repeat select parameter); notation and encoding will page-flip and scroll to first selected element; overrides page parameter
page=number Specify a page number to be displayed (depends on breaks settings; overridden by select, see above)
speed=true|false Set speed mode
fork=true|false If a https://raw.githubusercontent.com URL is supplied via the file parameter (see above), direct the user to fork the corresponding repository and open their forked version (logging them in first if necessary)
autoValidate=true|false Activate (default) or deactivate automatic validation upon MEI text input
Example:
https://mei-friend.mdw.ac.at/?file=https://raw.githubusercontent.com/trompamusic-encodings/Schumann-Clara_Romanze-in-a-Moll/master/Schumann-Clara_Romanze-ohne-Opuszahl_a-Moll.mei&orientation=top&select=beam-0000001097443359,staff-0000001071700568,chord-0000002117575656,chord-0000000554871076&select=slur-0000000400617177,slur-0000001381747608&speed=true&breaks=auto