mei-friend

A viewer and lightweight editor for MEI score encodings.
trompamusic
0.3.8 198
Flag as spam or malicious

mei-friend package for Atom

This package for the Atom editor will grow into a friendly companion that helps you edit and improve digital score encodings in MEI format. It makes extensive use of the fantastic engraving engine Verovio. This package started on the code of the mei-tools-atom package by Sienna M. Wood and the nCoda team.

This package is currently under development.

Current Features

Display

  • As-you-type rendering of MEI into music notation with Verovio.
  • Scale notation (zoom in or out) for ease of viewing.
  • Update notation to current cursor position in MEI encoding.
  • Breaks options (automatic system breaks, encoded system breaks, encoded system and page breaks, none).
  • Font drop down selector
  • Element under cursor in MEI code is highlighted in notation window
    • this feature works by matching xml:ids, so if you have no xml:ids on your elements you will have no highlighting in your notation.
    • if the current element has no xml:id, the parent <staff> and then <measure> will be checked for an xml:id and will be highlighted if one is found.
  • Click on a note or other rendered notation element to take the cursor to the associated place in the MEI code
    • also relies on xml:ids, so elements without xml:ids do not provide this feature.
  • Refactor the MEI encoding by running it through Verovio, adding xml:ids to elements without ids.
  • Speed mode checkbox: only the visible page is sent to Verovio to improve GUI responsiveness and reduce rendering duration. Works currently only with the breaks option set to System (line) and Page and System (encoded). (Known issues are: time spanning elements with @tstamps reaching into or out from current page not shown.)

Editing functionality

  • Navigation within the notation window by arrow keys (combined with CMD and CTRL for measure-wise and page-wise stepping).
  • Select one or more elements in the Verovio panel (CTRL + click for multiple notes, Mac OSX: CMD + click).
  • Select chord instead of note with ALT + click.
  • Insert slur, tie (with placement above by default or below with CTRL).
  • Insert crescendo hairpin or diminuendo hairpin to two selected notes.
  • Insert glissando, arpeggio elements at selected notes.
  • Insert fermata to selected note (above by default or below and inverted with CTRL).
  • Insert directives, dynamics, tempo indications to selected notes (above by default or below with CTRL).
  • Insert pedal up/down.
  • Insert turn, mordent (non-default forms with SHIFT).
  • Insert trill (with @extender, if two notes selected).
  • Invert placement (@place for accid, artic, dir, dynam, etc.) and curvature (for slur, tie, etc.) (X).
  • Invert @stem.dir for selected notes/chords or elements containing those (X).
  • Delete control elements with BACKSPACE or DELETE key (and accid, artic, clef).
  • Toggle articulation on notes or chords (staccato, tenuto, marcato, accent, staccatissimo)
  • Move rests (rest, mRest, multiRest) and notes up/downwards (SHIFT + up/down, CMD/CTRL + SHIFT + Up/Down)
  • Move notes, chords, rests to next staff above/below (ALT + CMD/CTRL + UP/DOWN)

Code manipulation utilities

  • Remove @accid.ges when @accid is present (SHIFT + C)
  • Renumber measures (counts successive measures with @metcon="false" as one, counts multiple endings with same numbering, does not count measures with invisible right bar line)
    • Test renumbering SHIFT + R, output to console, no manipulation done.
    • Execute renumbering CTRL-SHIFT + R

Installation

This package is published to the official Atom registry and can be installed by following their general instructions. If prompted to install dependencies, click 'yes' and allow installation to complete.

Once installed, use the package by following these steps:

  1. Launch Atom and open an MEI file (menu item File > Open...).
  2. To display the notation, use the menu item Packages > MEI Friend > Show/Hide Notation, or press Alt Cmd M (Mac), or Alt Win M (Windows, Linux).

Validating your MEI encoding

Only valid MEI can be rendered into notation with Verovio. To ensure your MEI is valid, an XML validation package is recommended.
linter-autocomplete-jing was designed for use with TEI and MEI, so I recommend starting there.
Please note that linter-autocomplete-jing requires Java Runtime Environment (JRE) v1.6 or above. Visit the package repository for details.

Acknowlegements

This package started on the code of the mei-tools-atom package by Sienna M. Wood and the nCoda team. Thanks to Laurent Pugin and the MEI community for all their work on Verovio. Thanks also to Laurent for making Verovio available as a Node package and for constant basic support on Verovio.