microcsound


Namemicrocsound JSON
Version 2.0.4 PyPI version JSON
download
home_pageNone
SummaryA tool for writing csound scores that can make handling microtones MUCH easier.
upload_time2024-08-18 18:02:23
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseCopyright 2017-2022 Aaron Krister Johnson <akjmicro@gmail.com> Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords csound microtonal microtonality
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## microcsound

### TO INSTALL:
____________

* Make sure you have Python and Csound installed

* Choose as install method, *pip* or *git* (pip is recommended if you have it)

**From pip:**
```
    pip install microcsound
```
__________________________________

**From git:**

Either download from the 'dist' directory here, or:
```
    git clone https://github.com/akjmicro/microcsound
```
Once downloaded, in the 'microcsound' directory:
```
    python -m pip install .
```
___________________________________

* Files will be installed into a Python lib directory on your system. E.G.,
on a Linux system, something like _/usr/local/lib/Python3.11_

* Copy `.microcsound.toml` to your home user directory, edit the values to your preferences

### ABOUT:

Microcsound implements the following features:

* an intuitive, clean shorthand syntax that allows one to both easily write
CSound scores

* a focus on flexible entry of microtonal music, the emphasis being on
enabling one to compose in various equal-temperaments and just
intonation.

* symbols for various microtonal commas, so that extended just
intonation harmony is easily accessible in a convenient intuitive way.

* implementation of chord notation using brackets

* implementation of a 'time pointer' notation which allows arbitrary
number of counterpoint layers in a single 'voice'

See the example 'ciconia.mc' (a rendering of a medieval piece, given in the
repo path `microcsound/share/data/ciconia.mc`) and the tutorials/docs for an
understanding of how to use the syntax for your own compositions.

## To use:

It's best to start by seeing all the command-line options, so first, try:
```
         $ microcsound -h
```

After writing a little example in a file you might name 'yourfile.mc', try
this:
```
         $ microcsound yourfile.mc
```

The script outputs a wave file to the current directory, by default the wave
is called 'microcsound_out.wav', but you can change this using the '-o' 
command line switch. If you use the '-s', it will avoid the 
final step of compiling the orc/score pair and just put a csound score to 
standard out. To put this output into a file, use redirection like so:
```
         $ microcsound -s yourfile.mc > yourcsoundscore.sco
```

You could also use an editor like 'joe' or 'emacs' that allows the
capture of the text output of a process, and call the script from
within the editing session of a .csd (orc+sco) file; in this way one
can be between the <CsScore> and </CsScore> tags and fill the space
with the script output.

For realtime experimentation, just call the script with the name of a
csound '.orc' file, you can edit the variables at the top of the script
so that it automatically looks for orchestra files in a default directory.

For instance:
```
	$ microcsound -i --orc fat_moog.orc
```

will give you a prompt, and you can type in a microcsound 'score', and when
you want it rendered, hit return and type 'done' and then hit return again.
In this example above, it will search in the directory I provided in the
script for the 'fat_moog.orc' file.	

See the csound documentation for how to use all the options and
command line switches to get the final audio output from csound.
The csound command called by the script can be changed at the top 
of the script in the "user variables" area.

Enjoy!

Aaron Krister Johnson

Please report bugs and successes to aaron@untwelve.org

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "microcsound",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Aaron Krister Johnson <akjmicro@gmail.com>",
    "keywords": "csound, microtonal, microtonality",
    "author": null,
    "author_email": "Aaron Krister Johnson <akjmicro@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/4e/fe/ac7ef309a3269a8aa443a0cf981fc978d4c187509d3907ca85318fa5f975/microcsound-2.0.4.tar.gz",
    "platform": null,
    "description": "## microcsound\n\n### TO INSTALL:\n____________\n\n* Make sure you have Python and Csound installed\n\n* Choose as install method, *pip* or *git* (pip is recommended if you have it)\n\n**From pip:**\n```\n    pip install microcsound\n```\n__________________________________\n\n**From git:**\n\nEither download from the 'dist' directory here, or:\n```\n    git clone https://github.com/akjmicro/microcsound\n```\nOnce downloaded, in the 'microcsound' directory:\n```\n    python -m pip install .\n```\n___________________________________\n\n* Files will be installed into a Python lib directory on your system. E.G.,\non a Linux system, something like _/usr/local/lib/Python3.11_\n\n* Copy `.microcsound.toml` to your home user directory, edit the values to your preferences\n\n### ABOUT:\n\nMicrocsound implements the following features:\n\n* an intuitive, clean shorthand syntax that allows one to both easily write\nCSound scores\n\n* a focus on flexible entry of microtonal music, the emphasis being on\nenabling one to compose in various equal-temperaments and just\nintonation.\n\n* symbols for various microtonal commas, so that extended just\nintonation harmony is easily accessible in a convenient intuitive way.\n\n* implementation of chord notation using brackets\n\n* implementation of a 'time pointer' notation which allows arbitrary\nnumber of counterpoint layers in a single 'voice'\n\nSee the example 'ciconia.mc' (a rendering of a medieval piece, given in the\nrepo path `microcsound/share/data/ciconia.mc`) and the tutorials/docs for an\nunderstanding of how to use the syntax for your own compositions.\n\n## To use:\n\nIt's best to start by seeing all the command-line options, so first, try:\n```\n         $ microcsound -h\n```\n\nAfter writing a little example in a file you might name 'yourfile.mc', try\nthis:\n```\n         $ microcsound yourfile.mc\n```\n\nThe script outputs a wave file to the current directory, by default the wave\nis called 'microcsound_out.wav', but you can change this using the '-o' \ncommand line switch. If you use the '-s', it will avoid the \nfinal step of compiling the orc/score pair and just put a csound score to \nstandard out. To put this output into a file, use redirection like so:\n```\n         $ microcsound -s yourfile.mc > yourcsoundscore.sco\n```\n\nYou could also use an editor like 'joe' or 'emacs' that allows the\ncapture of the text output of a process, and call the script from\nwithin the editing session of a .csd (orc+sco) file; in this way one\ncan be between the <CsScore> and </CsScore> tags and fill the space\nwith the script output.\n\nFor realtime experimentation, just call the script with the name of a\ncsound '.orc' file, you can edit the variables at the top of the script\nso that it automatically looks for orchestra files in a default directory.\n\nFor instance:\n```\n\t$ microcsound -i --orc fat_moog.orc\n```\n\nwill give you a prompt, and you can type in a microcsound 'score', and when\nyou want it rendered, hit return and type 'done' and then hit return again.\nIn this example above, it will search in the directory I provided in the\nscript for the 'fat_moog.orc' file.\t\n\nSee the csound documentation for how to use all the options and\ncommand line switches to get the final audio output from csound.\nThe csound command called by the script can be changed at the top \nof the script in the \"user variables\" area.\n\nEnjoy!\n\nAaron Krister Johnson\n\nPlease report bugs and successes to aaron@untwelve.org\n",
    "bugtrack_url": null,
    "license": "Copyright 2017-2022 Aaron Krister Johnson <akjmicro@gmail.com>  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ",
    "summary": "A tool for writing csound scores that can make handling microtones MUCH easier.",
    "version": "2.0.4",
    "project_urls": {
        "Homepage": "https://untwelve.org/microcsound",
        "Repository": "https://github.com/akjmicro/microcsound"
    },
    "split_keywords": [
        "csound",
        " microtonal",
        " microtonality"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ca9c660fcecce9776ec9f699e015c82354646b2be57579a372c2626ed7b25d72",
                "md5": "af5d9837d3112f849ed7621bbaaac1a6",
                "sha256": "d05bc5c18eee47126f2184646ac393585825beda2dcaa7a7671a8b265b2c6774"
            },
            "downloads": -1,
            "filename": "microcsound-2.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "af5d9837d3112f849ed7621bbaaac1a6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 40959,
            "upload_time": "2024-08-18T18:02:22",
            "upload_time_iso_8601": "2024-08-18T18:02:22.010470Z",
            "url": "https://files.pythonhosted.org/packages/ca/9c/660fcecce9776ec9f699e015c82354646b2be57579a372c2626ed7b25d72/microcsound-2.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4efeac7ef309a3269a8aa443a0cf981fc978d4c187509d3907ca85318fa5f975",
                "md5": "e3c3427043328ff66d758566bbd721bd",
                "sha256": "d4cdde8389a1ad1e5b8b34ae6df85e941184f4346b0c8ed1578930ad95a93cbf"
            },
            "downloads": -1,
            "filename": "microcsound-2.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "e3c3427043328ff66d758566bbd721bd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 36845,
            "upload_time": "2024-08-18T18:02:23",
            "upload_time_iso_8601": "2024-08-18T18:02:23.896965Z",
            "url": "https://files.pythonhosted.org/packages/4e/fe/ac7ef309a3269a8aa443a0cf981fc978d4c187509d3907ca85318fa5f975/microcsound-2.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-18 18:02:23",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "akjmicro",
    "github_project": "microcsound",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "microcsound"
}
        
Elapsed time: 0.31656s