# Python client for SuperCollider
A lightweight Python module to control the [SuperCollider](https://supercollider.github.io) audio synthesis engine.
## Installation
To install the client library:
```python
pip3 install supercollider
```
## Usage
Before using the library, start the SuperCollider server, either through the SuperCollider GUI or with `scsynth -u 57110`.
Within the SC client, create the below SynthDef:
```
SynthDef(\sine, { |out = 0, freq = 440.0, gain = 0.0|
Out.ar(out, SinOsc.ar(freq) * gain.dbamp);
}).store;
```
From Python, you can now create and trigger Synths:
```python
from supercollider import Server, Synth
server = Server()
synth = Synth(server, "sine", { "freq" : 440.0, "gain" : -12.0 })
synth.set("freq", 880.0)
```
For further examples, see [examples](https://github.com/ideoforms/python-supercollider/tree/master/examples).
## License
This library is made available under the terms of the MIT license.
## Contributors
- Thanks to [Itaborala](https://github.com/Itaborala) for porting from liblo to python-osc
## See also
* If you want a more comprehensive framework that lets you construct and compile SynthDefs from Python, take a look at [Supriya](https://github.com/josiah-wolf-oberholtzer/supriya).
* For an excellent Python + SuperCollider live coding environment, check out [FoxDot](https://foxdot.org)
Raw data
{
"_id": null,
"home_page": "https://github.com/ideoforms/supercollider",
"name": "supercollider",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "sound,music,supercollider,synthesis",
"author": "Daniel Jones",
"author_email": "dan-code@erase.net",
"download_url": "https://files.pythonhosted.org/packages/17/35/d2021a981d44211028118f0d64ec15cf49a72f16878c26280468b72761ee/supercollider-0.0.6.tar.gz",
"platform": null,
"description": "# Python client for SuperCollider\n\nA lightweight Python module to control the [SuperCollider](https://supercollider.github.io) audio synthesis engine.\n\n## Installation\n\nTo install the client library:\n\n```python\npip3 install supercollider\n```\n\n## Usage\n\nBefore using the library, start the SuperCollider server, either through the SuperCollider GUI or with `scsynth -u 57110`.\n\nWithin the SC client, create the below SynthDef:\n\n```\nSynthDef(\\sine, { |out = 0, freq = 440.0, gain = 0.0|\n Out.ar(out, SinOsc.ar(freq) * gain.dbamp);\n}).store;\n```\n\nFrom Python, you can now create and trigger Synths:\n\n```python\nfrom supercollider import Server, Synth\n\nserver = Server()\n\nsynth = Synth(server, \"sine\", { \"freq\" : 440.0, \"gain\" : -12.0 })\nsynth.set(\"freq\", 880.0)\n```\n\nFor further examples, see [examples](https://github.com/ideoforms/python-supercollider/tree/master/examples).\n\n## License\n\nThis library is made available under the terms of the MIT license.\n\n## Contributors\n\n - Thanks to [Itaborala](https://github.com/Itaborala) for porting from liblo to python-osc\n\n## See also\n\n* If you want a more comprehensive framework that lets you construct and compile SynthDefs from Python, take a look at [Supriya](https://github.com/josiah-wolf-oberholtzer/supriya).\n* For an excellent Python + SuperCollider live coding environment, check out [FoxDot](https://foxdot.org)\n",
"bugtrack_url": null,
"license": "",
"summary": "Interact with the SuperCollider audio synthesis engine",
"version": "0.0.6",
"project_urls": {
"Homepage": "https://github.com/ideoforms/supercollider"
},
"split_keywords": [
"sound",
"music",
"supercollider",
"synthesis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1735d2021a981d44211028118f0d64ec15cf49a72f16878c26280468b72761ee",
"md5": "9bbb60e0df0e977d7cb24b8feda72077",
"sha256": "7e0be449e44feec3573ecffc1c787c7744e8e12a5254874e2f14acb58a5fac61"
},
"downloads": -1,
"filename": "supercollider-0.0.6.tar.gz",
"has_sig": false,
"md5_digest": "9bbb60e0df0e977d7cb24b8feda72077",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 11089,
"upload_time": "2024-01-12T11:31:10",
"upload_time_iso_8601": "2024-01-12T11:31:10.867183Z",
"url": "https://files.pythonhosted.org/packages/17/35/d2021a981d44211028118f0d64ec15cf49a72f16878c26280468b72761ee/supercollider-0.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-12 11:31:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ideoforms",
"github_project": "supercollider",
"github_not_found": true,
"lcname": "supercollider"
}