Skip to main content

event based framework for generative art

Project description

mutwo

Build Status docs License: GPL v3 PyPI version Code style: black

disclaimer: This framework is still in an early stage of development and the API may still change until version 1.0.0.

Mutwo is a flexible, modular, event based framework for composing music or other time-based arts in Python. It aims to help composers to build musical structures in a meaningful way and translate those structures to different third party objects (e.g. midi files, csound scores, musical notation with Lilypond via abjad). The general design philosophy stresses out the independence and freedom of the user with the help of generic data structures and an easily extensible and tweakable software design.

The following example generates a short midi file:

from mutwo.core.events import basic
from mutwo.ext.events import music
from mutwo.ext.converters import frontends
simple_melody = basic.SequentialEvent(
    [
        music.NoteLike(pitch_name, duration=duration, volume="mf")
        for pitch_name, duration in (
            ("c", 0.75),
            ("a", 0.25),
            ("g", 1 / 6),
            ("es", 1 / 12),
        )
    ]
)
midi_file_converter = frontends.midi.MidiFileConverter()
midi_file_converter.convert(simple_melody, "my_simple_melody.mid")

Making Western notation via abjad of the same melody:

import abjad
abjad_voice_converter = frontends.abjad.SequentialEventToAbjadVoiceConverter()
abjad_voice = abjad_voice_converter.convert(simple_melody)
abjad_score = abjad.Score([abjad.Staff([abjad_voice])])
abjad.show(abjad_score)

Lilypond engraving

Plugins

Starting from version 0.43.0 mutwo uses a modular design. Only basic and internal functionality is provided by the main mutwo core package. For adding various third party converter or better representation for certain areas the mutwo ecosystem supports plugin-like extensions. The following list gives an overview of currently supported extensions:

Writing new plugins is simple, its basic structure can be understood at the mutwo.ext-example repo.

Documentation

For more information how to use mutwo read the documentation.

Installation

Mutwo is available on pypi and can be installed via pip:

pip3 install mutwo

This only installs the core functionality (see plugins above).

Similar projects

There are a many similar composition frameworks. Maybe one of them fits better to your particular use-case:

Python based composition frameworks:

  • scamp: "SCAMP is a computer-assisted composition framework in Python designed to act as a hub, flexibly connecting the composer-programmer to a variety of resources for playback and notation."
  • isobar: "isobar is a Python library for creating and manipulating musical patterns, designed for use in algorithmic composition, generative music and sonification."
  • JythonMusic: "JythonMusic is an environment for music making and creative programming."

Composition frameworks in other languages:

  • slippery-chicken: "a Common Lisp and CLOS package for algorithmic composition."
  • OpenMusic: "OpenMusic (OM) is a visual programming language for computer-assisted music composition created at IRCAM, inheriting from a long tradition of computer-assisted composition research."
  • Euterpea: "Euterpea is a cross-platform, domain-specific language for computer music applications embedded in the Haskell programming language."
  • jMusic: "jMusic is a project designed to provide composers and software developers with a library of compositional and audio processing tools."
  • Comic: "A Lisp-Environment for Inter-Media Composition."

Project details


Download files

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

Source Distribution

mutwo-0.50.1.tar.gz (20.3 kB view details)

Uploaded Source

Built Distribution

mutwo-0.50.1-py3-none-any.whl (20.7 kB view details)

Uploaded Python 3

File details

Details for the file mutwo-0.50.1.tar.gz.

File metadata

  • Download URL: mutwo-0.50.1.tar.gz
  • Upload date:
  • Size: 20.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

File hashes

Hashes for mutwo-0.50.1.tar.gz
Algorithm Hash digest
SHA256 132257e62cd599a78351cb06d2524580032981e32289986135c7d71bc07015e8
MD5 5ed7066a48bcac7112ef456e9e728039
BLAKE2b-256 29077a401781f9e8137d5e130192ac44cb23254a2a39ff0dd9dcd2075d6afdff

See more details on using hashes here.

File details

Details for the file mutwo-0.50.1-py3-none-any.whl.

File metadata

  • Download URL: mutwo-0.50.1-py3-none-any.whl
  • Upload date:
  • Size: 20.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.1 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

File hashes

Hashes for mutwo-0.50.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b37ffd19318c17a784ea02e7bd4808553f673c3eb9a2efe2e4a6dd8e7a37c42c
MD5 982d1e663a43a838a9725eb8f55c3c8a
BLAKE2b-256 c1d4cc1db18828d48629e8af95e50c2a2f61f205f78def271d3b1f7121ea9d68

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page