Installation

mutwo is written and used in the programming language Python. You need to have Python 3.10 or any later version to use mutwo. Perhaps your machine already has Python installed, if not consult the Python documentation. To check whether you python version is new enough, simply run:

python3 --version

Python dependencies

Mutwo packages are available on the Python package ecosystem pypi and can be installed via the package installer pip. Mutwo doesn’t consist of one single package, but is split into small packages where each of those packages fulfill only one specific purpose. In this way users only need to install the functionality they need and mutwo becomes easily extendable. All mutwo packages depend on the fundamental mutwo.core package.

pip3 install mutwo.core

In order to use different backends or frontends (midi, abjad, …) and to have more inner functionality, mutwo needs additional packages.

To represent musical structures in mutwo, you need mutwo.music:

pip3 install mutwo.music

If want to import or export MIDI files, you need to install mutwo.midi:

pip3 install mutwo.midi

Other dependencies

Some export or import functionalities need additional software that isn’t automatically installed when using pip. You need to manually install this additional software by either using your OS package manager (Linux) or by downloading and installing precompiled binaries (OSX, Windows)

To use the Csound converter, install Csound first. To use Lilypond via mutwos abjad converter (mutwo.abjad), install Lilypond first.

Use nix to install python and other dependencies together

Alternatively to pip and your OS package manager, you can use the package manager Nix to install all mutwo dependencies together. Mutwo has its own repo for the packages.

Operating system

mutwo is tested on Linux, but may equally well work on OSX or Windows.