musical_games


Namemusical_games JSON
Version 0.8.9 PyPI version JSON
download
home_pageNone
SummaryImplementation of musical dice games from the 18th century.
upload_time2024-05-13 12:30:52
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords musical games dice games piano music
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            #############
Musical Games
#############
This package features an implementation of various musical dice games by Mozart, Kirnberger and Stadler.
These dice games are also known as "Musikalisches Würfelspiel" (German for "musical dice game").

The earliest printed edition of a dice game is Johann Philipp Kirnberger's "Der allezeit fertige Menuetten- und Polonaisencomponist"
(The ever-ready minuet and polonaise composer"), published in 1757.
Afterwards, many composers, such as, for example, C.P.E. Bach, Hayden, and Mozart, published these so called
"Musikalische Würfelspiele" (musical dice games) all over Europe.
The music style varies roughly between Gregorian chants up to and including the salon pieces of the Romantic period. See [Reuter2013]_ for more details.

To play a dice game, one would need:

- two dice
- a tables sheet with the measure indices
- a measures sheet with all the numbered bars
- music paper to write down your composition

The measures and tables where composed by the composer of the dice game and were organized such,
that random compilations made a musical composition.
To play the game, you would have to throw the dice, and then look up the measure
corresponding to your dice throw and your bar index in the dice table.
Having found the right bar number, you then select that bar from the measures sheet provided.

This software package automizes the production of these musical pieces.
All pieces (tables sheets and measures) have been inserted into this software package and
suitable software has been created to allow production of the musical pieces.

For a use case of this library, and more information on these dice games, please visit http://opus-infinity.org,
a website by the same author.

For complete functionality, this package requires the following packages to be installed on the user's system:

- lilypond, to convert the compositions into midi and pdf files
- fluidsynth or timidity, for converting midi to wav
- ffmpeg, to convert wav to other audio formats
- imagemagick, to prepare the image outputs of the compositions

**********
Python API
**********
The major component of this library is the class "DiceGame". All dicegames implement this class and its funcions.
For use cases, please see the demo's in the `scripts` folder.


*****************
Technical details
*****************
All musical dice games are stored internally using Lilypond bars.
When composed into a musical piece, these bars are combined to form a complete piece.
The external package Lilypond is then called to convert the composition into a midi file and a pdf file.
Next, fluidsynth, or timidity is used to convert the midi to wav, either using a default soundfont, or a user provided soundfont.
Afterwards, the composition pdf can be transformed to png for display in, for example, a browser.


.. [Reuter2013] Reuter, Christoph. (2013), Der Würfel als Autor, Würfelmusik und Zufallstexte des 17. bis 19. Jahrhunderts. In: Herbert Bannert, Elisabeth Klecker (Hgg.), Autorschaft, Konzeptionen, Transformationen, Diskussionen. Wien, Praesens Verlag. p. 195-222.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "musical_games",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "Musical games, Dice games, Piano music",
    "author": null,
    "author_email": "Robbert Harms <robbert@xkls.nl>",
    "download_url": "https://files.pythonhosted.org/packages/ff/e4/3e53009ce103a2c73a96a9e6f520d38f49e5f390b2aa12b9e8be69cc16f4/musical_games-0.8.9.tar.gz",
    "platform": null,
    "description": "#############\nMusical Games\n#############\nThis package features an implementation of various musical dice games by Mozart, Kirnberger and Stadler.\nThese dice games are also known as \"Musikalisches W\u00fcrfelspiel\" (German for \"musical dice game\").\n\nThe earliest printed edition of a dice game is Johann Philipp Kirnberger's \"Der allezeit fertige Menuetten- und Polonaisencomponist\"\n(The ever-ready minuet and polonaise composer\"), published in 1757.\nAfterwards, many composers, such as, for example, C.P.E. Bach, Hayden, and Mozart, published these so called\n\"Musikalische W\u00fcrfelspiele\" (musical dice games) all over Europe.\nThe music style varies roughly between Gregorian chants up to and including the salon pieces of the Romantic period. See [Reuter2013]_ for more details.\n\nTo play a dice game, one would need:\n\n- two dice\n- a tables sheet with the measure indices\n- a measures sheet with all the numbered bars\n- music paper to write down your composition\n\nThe measures and tables where composed by the composer of the dice game and were organized such,\nthat random compilations made a musical composition.\nTo play the game, you would have to throw the dice, and then look up the measure\ncorresponding to your dice throw and your bar index in the dice table.\nHaving found the right bar number, you then select that bar from the measures sheet provided.\n\nThis software package automizes the production of these musical pieces.\nAll pieces (tables sheets and measures) have been inserted into this software package and\nsuitable software has been created to allow production of the musical pieces.\n\nFor a use case of this library, and more information on these dice games, please visit http://opus-infinity.org,\na website by the same author.\n\nFor complete functionality, this package requires the following packages to be installed on the user's system:\n\n- lilypond, to convert the compositions into midi and pdf files\n- fluidsynth or timidity, for converting midi to wav\n- ffmpeg, to convert wav to other audio formats\n- imagemagick, to prepare the image outputs of the compositions\n\n**********\nPython API\n**********\nThe major component of this library is the class \"DiceGame\". All dicegames implement this class and its funcions.\nFor use cases, please see the demo's in the `scripts` folder.\n\n\n*****************\nTechnical details\n*****************\nAll musical dice games are stored internally using Lilypond bars.\nWhen composed into a musical piece, these bars are combined to form a complete piece.\nThe external package Lilypond is then called to convert the composition into a midi file and a pdf file.\nNext, fluidsynth, or timidity is used to convert the midi to wav, either using a default soundfont, or a user provided soundfont.\nAfterwards, the composition pdf can be transformed to png for display in, for example, a browser.\n\n\n.. [Reuter2013] Reuter, Christoph. (2013), Der W\u00fcrfel als Autor, W\u00fcrfelmusik und Zufallstexte des 17. bis 19. Jahrhunderts. In: Herbert Bannert, Elisabeth Klecker (Hgg.), Autorschaft, Konzeptionen, Transformationen, Diskussionen. Wien, Praesens Verlag. p. 195-222.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Implementation of musical dice games from the 18th century.",
    "version": "0.8.9",
    "project_urls": null,
    "split_keywords": [
        "musical games",
        " dice games",
        " piano music"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "13ce9c094ea6270bf4f521d868766f5f69f164857123df1379487d8c87dcb0fe",
                "md5": "a53726c89620b4e57c8abc3549979b74",
                "sha256": "37f0c6751c3edd3fddbc2e1ed7d3c9d0369f57fbfdd88e2e581dc0ab6a420f91"
            },
            "downloads": -1,
            "filename": "musical_games-0.8.9-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a53726c89620b4e57c8abc3549979b74",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 95517,
            "upload_time": "2024-05-13T12:30:50",
            "upload_time_iso_8601": "2024-05-13T12:30:50.045640Z",
            "url": "https://files.pythonhosted.org/packages/13/ce/9c094ea6270bf4f521d868766f5f69f164857123df1379487d8c87dcb0fe/musical_games-0.8.9-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ffe43e53009ce103a2c73a96a9e6f520d38f49e5f390b2aa12b9e8be69cc16f4",
                "md5": "2cf6f9df303394b9bf477034a3536e98",
                "sha256": "ba4976ff32d1ba42aa0f8ae0b4cbe51a4bf30590cd6cdcfc79bbe912d2520314"
            },
            "downloads": -1,
            "filename": "musical_games-0.8.9.tar.gz",
            "has_sig": false,
            "md5_digest": "2cf6f9df303394b9bf477034a3536e98",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 86911,
            "upload_time": "2024-05-13T12:30:52",
            "upload_time_iso_8601": "2024-05-13T12:30:52.502371Z",
            "url": "https://files.pythonhosted.org/packages/ff/e4/3e53009ce103a2c73a96a9e6f520d38f49e5f390b2aa12b9e8be69cc16f4/musical_games-0.8.9.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-13 12:30:52",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "musical_games"
}
        
Elapsed time: 0.31417s