Skip to content

musicxml2lilypond v0.9.1
Compare
Choose a tag to compare
@sertansenturk sertansenturk released this 15 Apr 05:22
· 63 commits to master since this release
v0.9.1
92e15fe

musicxml2lilypond

Python package that converts the a makam-musicxml score to lilypond

Introduction

This repositry provides a simple and reliable conversion of a makam music score from MusicXML format to LilyPond format.

You can obtain 2200 makam music scores in MusicXML format from SymbTr collection. Alternatively you canuse the SymbTr-txt files in the collection and generate a MusicXML file with different options using the MusicXMLConverter repository.

The LilyPond format is useful not only it's music engraving capabilities but also the Lilypond softwares powerful svg conversion as the musical elements in the Lilypond and svg files are mapped to each other. This package is currently used in Dunya-makam website in the SymbTr conversion "chain" from txt -> MusicXML -> LilyPond -> svg. The resultant svg files are displayed in the recording page synchronous to the audio playback.

Usage

from musicxml2lilypond.musicxml2lilypond import ScoreConverter

# input MusicXML file
xml_file = "samplescores/pesendide--sazsemaisi--aksaksemai----iii_selim.xml"

# output lilypond file
ly_file = "samplescores/pesendide--sazsemaisi--aksaksemai----iii_selim.ly"

# output json file storing the mappings beteen ly and musicxml files.
map_file = "samplescores/pesendide--sazsemaisi--aksaksemai----iii_selim.json"

# instantiate
converter = ScoreConverter()
ly_stream, mapping = converter.run(xml_file, ly_out=ly_file, map_out=map_file,
                                   render_metadata=False)

Installation

Note: This package is in active development. The capabilities and calls might change significantly until the first stable release. For this reason we suggest the users to stick to the released versions, for the most reliable performance.

If you want to install musicxml2lilypond, it is recommended to install the package and its dependencies into a virtualenv. In the terminal, do the following:

virtualenv env
source env/bin/activate
python setup.py install

If you want to be able to edit files and have the changes be reflected, then
install the repository like this instead:

pip install -e .

Now you can install the rest of the dependencies:

pip install -r requirements

Changelog

  • Refactored the code to improve readability and maintenance

Authors

Hasan Sercan Atlı hsercanatli AT gmail DOT com
Burak Uyar burakuyar AT gmail DOT com
Andrés Ferraro andres DOT ferraro AT upf DOT edu
Sertan Şentürk contact AT sertansenturk DOT com

Reference

Sercan's Thesis

Assets 2
Loading