Skip to main content

Build Status codecov Maintainability PyPI version

Dodecaphony

Overview

This is a configurable tool that generates music written in the twelve-tone technique. In short, this means that the output pieces are based on different principles than the vast majority of classical and popular music. If you have never listened to the twelve-tone works, you may find them not ear-pleasant, but, given enough experience, you can change your mind. Twelve-tone music is logic-oriented and has many symmetries, so it is a good choice for combinatorial optimization.

Each run of the tool results in creation of a fragment which can be used as a part of a larger composition. These fragments are stored in separate directories containing:

  • MIDI file
  • WAV file
  • Events file in sinethesizer TSV format
  • PDF file with sheet music and its Lilypond source
  • YAML file that can be copied to a config for a derivative fragment
  • Text file with meta information (such as path to config and evaluation scores)

With this tool, I released a 26-minutes album on Spotify and many other streaming platforms. However, main melodies for the album were written manually by myself and a lot of hard work was done with configs, but, nevertheless, the package really helped to generate background melodies. To read more about the album, please visit its official page.

Installation

To install a stable version, run:

pip install dodecaphony

Usage

To create a new musical fragment, run:

python -m dodecaphony [-c path_to_config]

Default config is used if -c argument is not passed. To create your own config, please look at this example with detailed explanations. Also, you can read the source code — it is structured and has built-in documentation.

If you are on macOS, please make sure that parallelism is enabled.

Metadata

Release files for dodecaphony 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dodecaphony 0.2.3
File Size Uploaded Provenance Actions
dodecaphony-0.2.3.tar.gz 65.6 kB With provenance Details for dodecaphony-0.2.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dodecaphony 0.2.3
File Interpreter ABI Platform Actions
dodecaphony-0.2.3-py3-none-any.whl Python 3 none any Details for dodecaphony-0.2.3-py3-none-any.whl

Total release size: 126.1 kB

Release files / dodecaphony-0.2.3.tar.gz

Download URL dodecaphony-0.2.3.tar.gz
Size 65.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ad940e4f5fc0b7a42d1b1720c543034e4cb83ad47261cabc21280f6bb19538e9
BLAKE2b-256 checksum
How to use checksums
5cc45645f739bbe546f28ee6d6373d7423d5b85b38c67d092f1b68df57ea1a00
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

Release files / dodecaphony-0.2.3-py3-none-any.whl

Download URL dodecaphony-0.2.3-py3-none-any.whl
Size 60.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cd4e5d5654d5acaae8679b3664f4049ab89ede60b37c3387d80fd81909b8b7ed
BLAKE2b-256 checksum
How to use checksums
bd2d8d59e8b73eaaa1654dfabb2b1b13a613954f3e517fe707540a09d471dae4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

Security for dodecaphony 0.2.3

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dodecaphony-0.2.3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 5, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

0.2.3 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page