[![Build Status](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml/badge.svg)](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml)
[![codecov](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony/branch/master/graph/badge.svg)](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony)
[![Maintainability](https://api.codeclimate.com/v1/badges/b83bc51361ac046bc7eb/maintainability)](https://codeclimate.com/github/Nikolay-Lysenko/dodecaphony/maintainability)
[![PyPI version](https://badge.fury.io/py/dodecaphony.svg)](https://pypi.org/project/dodecaphony/)
# Dodecaphony
## Overview
This is a configurable tool that generates music written in [the twelve-tone technique](https://nikolay-lysenko.github.io/2024/04/30/introduction-to-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](https://github.com/Nikolay-Lysenko/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](https://nikolay-lysenko.github.io/2024/05/31/suite-for-virtual-pipe-organ-op1).
## Installation
To install a stable version, run:
```bash
pip install dodecaphony
```
## Usage
To create a new musical fragment, run:
```bash
python -m dodecaphony [-c path_to_config]
```
[Default config](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/dodecaphony/configs/default_config.yml) is used if `-c` argument is not passed. To create your own config, please look at [this example](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/docs/config_with_explanations.yml) 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](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr).
Raw data
{
"_id": null,
"home_page": null,
"name": "dodecaphony",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ai_music, algorithmic_composition, atonality, dodecaphony, serialism, twelve_tone",
"author": null,
"author_email": "Nikolay Lysenko <nikolay-lysenco@yandex.ru>",
"download_url": "https://files.pythonhosted.org/packages/25/70/055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee/dodecaphony-0.2.1.tar.gz",
"platform": null,
"description": "[![Build Status](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml/badge.svg)](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml)\n[![codecov](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony/branch/master/graph/badge.svg)](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony)\n[![Maintainability](https://api.codeclimate.com/v1/badges/b83bc51361ac046bc7eb/maintainability)](https://codeclimate.com/github/Nikolay-Lysenko/dodecaphony/maintainability)\n[![PyPI version](https://badge.fury.io/py/dodecaphony.svg)](https://pypi.org/project/dodecaphony/)\n\n# Dodecaphony\n\n## Overview\n\nThis is a configurable tool that generates music written in [the twelve-tone technique](https://nikolay-lysenko.github.io/2024/04/30/introduction-to-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.\n\nEach 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:\n* MIDI file\n* WAV file\n* Events file in [sinethesizer](https://github.com/Nikolay-Lysenko/sinethesizer) TSV format\n* PDF file with sheet music and its Lilypond source\n* YAML file that can be copied to a config for a derivative fragment\n* Text file with meta information (such as path to config and evaluation scores)\n\nWith 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](https://nikolay-lysenko.github.io/2024/05/31/suite-for-virtual-pipe-organ-op1).\n\n## Installation\n\nTo install a stable version, run:\n```bash\npip install dodecaphony\n```\n\n## Usage\n\nTo create a new musical fragment, run:\n```bash\npython -m dodecaphony [-c path_to_config]\n```\n\n[Default config](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/dodecaphony/configs/default_config.yml) is used if `-c` argument is not passed. To create your own config, please look at [this example](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/docs/config_with_explanations.yml) with detailed explanations. Also, you can read the source code \u2014 it is structured and has built-in documentation.\n\nIf you are on macOS, please make sure that [parallelism is enabled](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr).\n",
"bugtrack_url": null,
"license": null,
"summary": "Algorithmic composition of modern classical music in the twelve-tone technique",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/Nikolay-Lysenko/dodecaphony"
},
"split_keywords": [
"ai_music",
" algorithmic_composition",
" atonality",
" dodecaphony",
" serialism",
" twelve_tone"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f188d251f4bdcafc5bc51abcf79adcfa8aa371e88ec6b0c1ec69043fd42e9095",
"md5": "fe9cf4a49ff0357413b9210624635067",
"sha256": "81859db72d81615f8d2aa128320f66ad40f8eabdc2c4ab7ae6efe9302c21dc6c"
},
"downloads": -1,
"filename": "dodecaphony-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fe9cf4a49ff0357413b9210624635067",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 59769,
"upload_time": "2024-08-06T09:47:32",
"upload_time_iso_8601": "2024-08-06T09:47:32.983081Z",
"url": "https://files.pythonhosted.org/packages/f1/88/d251f4bdcafc5bc51abcf79adcfa8aa371e88ec6b0c1ec69043fd42e9095/dodecaphony-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2570055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee",
"md5": "3c36268410859f84554426c4ea73cd24",
"sha256": "614d0ab12fb68d01f2c1b2aabb6bddba4d94b878dfc8d3005e018ba7290624af"
},
"downloads": -1,
"filename": "dodecaphony-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "3c36268410859f84554426c4ea73cd24",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 64664,
"upload_time": "2024-08-06T09:47:34",
"upload_time_iso_8601": "2024-08-06T09:47:34.762999Z",
"url": "https://files.pythonhosted.org/packages/25/70/055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee/dodecaphony-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-06 09:47:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Nikolay-Lysenko",
"github_project": "dodecaphony",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "dodecaphony"
}