mutwo
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)
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:
- mutwo.ext-music: Improve workflow in writing traditional note based music by adding the
mutwo.ext.events.musicmodule - mutwo.ext-common-generators: Algorithmic generation of data to be used for artistic works
- mutwo.ext-midi: Render mutwo events to midi files
- mutwo.ext-abjad: Build Lilypond based Western score notation via Abjad
- mutwo.ext-csound: Create electronic music parts via csound
- mutwo.ext-isis: Use singing synthesis via ISiS
- mutwo.ext-reaper: Helpful converters for the Reaper DAW
- mutwo.ext-ekmelily: Simplify writing microtonal notation in Lilypond by rendering files for the Lilypond extension Ekmelily
- mutwo.ext-mmml: Write music in plain text files and convert it to mutwo events (experimental)
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."
1 maintainer
Metadata
1 maintainer
Release files for mutwo 0.50.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mutwo-0.50.1.tar.gz | 20.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mutwo-0.50.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.0 kB
Release files / mutwo-0.50.1.tar.gz
| Download URL | mutwo-0.50.1.tar.gz |
|---|---|
| Size | 20.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
132257e62cd599a78351cb06d2524580032981e32289986135c7d71bc07015e8
|
|
BLAKE2b-256 checksum How to use checksums |
29077a401781f9e8137d5e130192ac44cb23254a2a39ff0dd9dcd2075d6afdff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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
|
Release files / mutwo-0.50.1-py3-none-any.whl
| Download URL | mutwo-0.50.1-py3-none-any.whl |
|---|---|
| Size | 20.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b37ffd19318c17a784ea02e7bd4808553f673c3eb9a2efe2e4a6dd8e7a37c42c
|
|
BLAKE2b-256 checksum How to use checksums |
c1d4cc1db18828d48629e8af95e50c2a2f61f205f78def271d3b1f7121ea9d68
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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
|
Security for mutwo 0.50.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
