Verovio MEI Viewer (module for Omeka S)
New versions of this module and support for Omeka S version 3.0 and above are available on GitLab, which seems to respect users and privacy better than the previous repository.
Verovio MEI Viewer is a module for Omeka S that integrates Verovio, a music notation engraving library designed for the Music Encoding Initiative. It displays XML-MEI and MusicXML files attached to items, so the visitor can read musical scores and listen them via MIDI.
- From the zip
Download the last release Verovio.zip from the list of releases (the
master does not contain the dependency), and uncompress it in the
- From the source and for development:
If the module was installed from the source, rename the name of the folder of
the module to
Verovio, and go to the root module, and run:
composer install --no-dev
The next times:
composer update --no-dev
Then install it like any other Omeka module.
Identification of xml mei files
Because mei files are xml files, they are not automatically recognized by Omeka.
To identify them, there are two solutions: use the file extension
install the module Next, that identify the xml-mei files with the unregistered
vendor media type
application/vnd.mei+xml. The point is the same for the
MusicXML files: use extensions
mxl. The vendor media type is
managed by the w3c:
The white lists of media types and extensions are automatically updated to allow to upload xml files, with the extension and media type above.
Display of MEI and MusicXML files
When a file has extension
musicxml, or media type
application/vnd.recordare.musicxml, it is automatically displayed anywhere,
in public site or in admin board.
mxl format (zipped musicxml) is not supported by the included
version of Verovio.
Warning: The display of the musical scores may be slow on some computers: Verovio converts xml files into svg in order to display them. For big xml files, it's recommended to prepare the rendering on the server and to send the svg file with the xml data.
Selection of the template of the viewer
A site setting allows to select one of the four default templates to display it: a simple viewer, the official viewer based on Bootstrap 3, the same viewer based on Bootstrap 4, and a viewer to be customized.
Warning: When the selected template uses jQuery, a js conflict may appear in the theme in some rare cases. So you may need to enable/disable or defer/undefer the jQuery library in the template.
Advanced display in public theme
Because the viewer is integrated as a renderer and not a helper, it is possible to display it anywhere via the media. In particular, you can use the standard block "Media" to display it in any page. So just render the media, with possible options, that are passed directly to the template:
A block layout is available too if needed for external urls. Furthermore, a view helper is available to render any url anywhere:
$options = ['source' => 'https://example.org/file.mei']; echo $this->verovio(null, $options);
For a better integration in the sites, it's possible to customize the template:
view/common/verovio-toolkit.phtml in your theme and update it.
Use it at your own risk.
It’s always recommended to backup your files and your databases and to check your archives regularly so you can roll back if needed.
See online issues on the module issues page on GitLab.
In consideration of access to the source code and the rights to copy, modify and redistribute granted by the license, users are provided only with a limited warranty and the software’s author, the holder of the economic rights, and the successive licensors only have limited liability.
In this respect, the risks associated with loading, using, modifying and/or developing or reproducing the software by the user are brought to the user’s attention, given its Free Software status, which may make it complicated to use, with the result that its use is reserved for developers and experienced professionals having in-depth computer knowledge. Users are therefore encouraged to load and test the suitability of the software as regards their requirements in conditions enabling the security of their systems and/or data to be ensured and, more generally, to use and operate it in the same conditions of security. This Agreement may be freely reproduced and published, provided it is not altered, and that no provisions are either added or removed herefrom.
- Copyright 2014-2019, Swiss RISM Office
Module Verovio for Omeka S:
- Copyright Daniel Berthereau, 2019-2021