verovio 3.1.0

A library and toolkit for engraving MEI music notation into SVG

Verovio is a fast, portable and lightweight library for engraving Music Encoding Initiative (MEI) digital scores into SVG images. Verovio also contains on-the-fly converters to render Plaine & Easie Code, Humdrum, Musedata, MusicXML, EsAC, and ABC digital scores.

Verovio is written in standard 2017 C++ and can be compiled as a standalone command-line tool, used as a compiled music-rendering library for applications (Qt, python), or compiled into Javascript using the Emscripten LLVM-to-JavaScript compiler. Check out the JavaScript toolkit version of verovio running in the MEI Viewer as well as the app or tutorials for web integration and user interaction.

Verovio uses the Standard Music Font Layout (SMuFL) specification and the font can be changed for personalizing the output.

The project page is http://www.verovio.org. Verovio is available under the LGPL license (see LICENSE.txt).

Building and use instructions by environment

See the wiki, with instructions for:

• Command-line tool
• XCode
• Visual Studio
• JavaScript
• NPM
• Python
• Java
• CocoaPods

LibMEI

The code for the attribute classes of Verovio are generated from the MEI schema using a modified version of LibMEI available here. The code generated is included in the Verovio repository and the LibMEI repository does not need to be cloned for building Verovio.

Major releases of Verovio and MEI versions:

• Verovio 1.x.x ⇔ MEI 3.0
• Verovio 2.x.x ⇔ MEI 4.0
• Verovio 3.x.x ⇔ Development of MEI since 4.0

From Verovio 2.x.x, the plan is to have even version numbers for Verovio releases using a stable version of MEI, and odd version numbers for releases using a development version of MEI. It means that once MEI 5.0 will be released, Verovio will move to version 4.x.x. Older versions of MEI are still supported by newer versions of Verovio. MEI files are internally upgraded when loaded into Verovio. This applies only to the features supported by Verovio. We will try to maintain this in the future.

Other libraries

The following libraries are embedded in Verovio:

library	purpose
humlib	Humdrum file import/export
JSON++	JSON data parser
MidiFile	Standard MIDI file export
pugixml	XML data parser
UTF-CPP	UTF character conversions

Contributing

If you are interested in contributing to Verovio, please read the contribution and coding style guidelines.

Example output

The sample page of music shown below was generated with version 2.4.0-dev-2748fed

Example resources using verovio

name	type	description
Verovio Humdrum Viewer	editor	An online semi-graphical Humdrum data editor (can also be used to textually edit other digital scores compliant with verovio).
MoVI	repertory	The digital Mozart digital score VIewer at the Mozarteum
Tasso in Music Project	repertory	Musical settings of the poetry of Torquato Tasso
Measuring Polyphony	repertory	Late medieval music in black mensural and modern notations
Probstücke Digital	repertory	open and critical digital edition of Mattheson's test pieces
370 Bach Chorales	repertory	Online edition of Bach chorales, including an interactive typesetter page that allows for creating musical examples for online display or use in papers.
Humdrum Notation Plugin	tool	Javascript interface to verovio for displaying multiple musical examples on a webpage
Music Sheet Viewer	tool	WordPress plugin for displaying graphical music from MEI data

Digital score repositories on Github

Here is a list of digital score repositories on Github that can be displayed with verovio:

link	encoding	description
MEI complete examples	MEI	86 various works encoded in MEI
Mozart Piano Sonatas	Humdrum	17 Piano sonatas by W.A. Mozart from the Alte Mozart-Ausgabe (in VHV)
Beethoven Piano Sonatas	Humdrum	32 Piano sonatas by L. van Beethoven, edited by Paul Dukas (in VHV)
Josquin Research Project	Humdrum	Over 1000 scores of early Renaissance music in modern editions (website)
Tasso in Music Project	Humdrum	Critical edition of 650 Late Renaissance madrigals using the poetry of Torquato Tasso for lyrics. (website)
Music of Scott Joplin	Humdrum	Digital scores of most of Scott Joplins music
Chopin mazurkas	Humdrum	Digital scores of Chopin's mazurkas
Chopin preludes	Humdrum	Digital scores of Chopin's op. 24 preludes
J.N. Hummel preludes, op. 67	Humdrum	24 improvisatory prelude examples in every key
370 Bach chorales	Humdrum	Chorales collected by C.P.E. Bach after his father's death (website)
Deutscher Liederschatz	Humdrum	200 harmonized songs from vol. 1, edited by Ludwig Erk
Beethoven string quartets	Humdrum	18 string quartets by Ludwig van Beethoven