Supriya lets you:
- boot and communicate with SuperCollider's
- construct and compile
SynthDefunit generator graphs in native Python code
- build and control graphs of synthesizers and synthesizer groups
scysnthOSC communications explicitly via
- compile non-realtime synthesis scores via Supriya's
This project is still under heavy development, is not yet stable, and is not yet intended for deployment in the field.
Send compliments or complaints to firstname.lastname@example.org, or register an issue at https://github.com/josiah-wolf-oberholtzer/supriya/issues.
Supriya is compatible with Python 3.3+ only.
1. Get Supriya and SuperCollider
Get Supriya from GitHub:
~$ git clone https://github.com/josiah-wolf-oberholtzer/supriya.git ~$ cd supriya supriya$ sudo pip install -e .
Run the tests to make sure everything's OK:
Consult our installation instructions for detailed help on getting Abjad, setting it up, and installing any additional dependencies like Graphviz.
2. Make some noise
Start your Python interpreter and import Supriya:
>>> import supriya
Boot the SuperCollider server:
>>> server = supriya.realtime.Server() >>> server.boot() <Server: udp://127.0.0.1:57751, 8i8o>
Create and allocate a group:
>>> group = supriya.realtime.Group().allocate()
Make a synthesizer definition and send it to the server:
>>> builder = supriya.synthdefs.SynthDefBuilder( ... amplitude=1.0, ... frequency=440.0, ... gate=1.0, ... )
>>> with builder: ... source = supriya.ugens.SinOsc.ar( ... frequency=builder['frequency'], ... ) ... envelope = supriya.ugens.EnvGen.kr( ... done_action=supriya.synthdefs.DoneAction.FREE_SYNTH, ... envelope=supriya.synthdefs.Envelope.asr(), ... gate=builder['gate'], ... ) ... source = source * builder['amplitude'] ... source = source * envelope ... out = supriya.ugens.Out.ar( ... bus=(0, 1), ... source=source, ... ) ...
>>> synthdef = builder.build().allocate()
Synchronize with the server:
>>> server.sync() <Server: udp://127.0.0.1:57751, 8i8o>
Create a synthesizer with the previously defined synthesizer definition:
>>> synth = servertools.Synth(synthdef) >>> synth <Synth: ???>
Allocate it on the server as a child of the previously created group:
>>> group.append(synth) >>> synth <Synth: 1001>
Query the server's node tree:
>>> response = server.query_remote_nodes(include_controls=True) >>> print(response) NODE TREE 0 group 1 group 1000 group 1001 f1c3ea5063065be20688f82b415c1108 amplitude: 0.0, frequency: 440.0
Bind a MIDI controller to the synth's controls:
>>> korg = supriya.midi.Device('NanoKontrol2') >>> korg.open_port(0) >>> source = korg['fader_1'] >>> target = synth.controls['frequency'] >>> supriya.bind(source, target, range_=Range(110, 880), exponent=2.0) Binding()
Release the synth:
Quit the server:
>>> server.quit() <Server: offline>