/geniartor

Generation of musical phrases that receive maximum score according to configurable evaluational criteria.

Primary LanguagePythonMIT LicenseMIT

Build Status codecov Maintainability PyPI version

Geniartor

Overview

This is a configurable tool that generates musical phrases or even short pieces.

Here, the process of composition is framed as follows: Variable Neighborhood Search (VNS) is applied to maximize user-defined weighted sum of evaluational criteria.

Each run of the tool results in creation of a directory that contains:

  • MIDI file;
  • WAV file;
  • Events file in sinethesizer TSV format;
  • PDF file with sheet music and its Lilypond source.

Sample outputs produced by the tool are uploaded to a cloud storage.

Installation

To install a stable version, run:

pip install geniartor

Usage

To create a new musical phrase, run:

python -m geniartor \
    [-c path_to_config] \
    [-n number_of_search_passes]

Both arguments are optional. Default config is used if -c argument is not passed. Similarly, -n option has a reasonable default too.

Advanced usage is covered in a guide.