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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.