Skip to main content

Generator for Notation Videos from Lilypond Text

Project description



The LilypondToBandVideoConverter is a system of several python scripts that orchestrate existing command line tools to convert a music piece written in the lilypond notation to

  • a PDF score of the whole piece,

  • several PDF voice extracts,

  • a MIDI file with all voices (with some preprocessing applied for humanization),

  • audio mix files with several subsets of voices (specified by configuration), and

  • video files for several output devices visualizing the score notation pages and having the mixes as mutually selectable audio tracks as backing tracks.

For processing a piece one must have

  • a lilypond fragment file with the score information containing specific lilypond identifiers, and

  • a configuration file giving details like the voices occuring in the piece, their associated midi instrument, target audio volume, list of mutable voices for the audio tracks etc.

Based on those files the python scripts -- together with some open-source command-line software like ffmpeg or fluidsynth -- produce all the target files either incrementally or altogether.

Installation and Requirements

All the scripts are written in python and can be installed as a python package. The package requires either Python 2.7 or Python 3.3 or later.

Additionally the following software has to be available:

  • lilypond: for generating the score pdf, voice extract pdfs, the raw midi file and the score images used in the video files,

  • ffmpeg: for video generation and video postprocessing,

  • fluidsynth: for generation of voice audio files from a midi file plus some soundfont (e.g. FluidR3_GM.sf3),

  • sox: for instrument-specific postprocessing of audio files for the target mix files as well as the mixdown, and

Optionally the following software is also used:

  • qaac: the AAC-encoder for the final audio mix file compression.

  • mp4box: the MP4 container packaging software

The location of all those commands as well as a few other settings has to be defined in a global configuration file for the LilypondToBandVideoConverter.

Installation is done from the PyPi repository via

pip install lilypondToBVC

Make sure that the scripts directory of python is in the path for executables on your platform.

Further Information

A longer description is available here and the detailed manual is available here.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
LilypondToBandVideoConverter-0.1.2.tar.gz (741.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page