Getting and Using CSLC
Pre-requisites
And a code editing environment that supports live coding to csound:
- emacs with csound-mode
- vim with csound-repl, and csound-vim
- vscode with the csound-vscode-plugin
- csoundQT
- csoundIDE
Download cslc.csd
Or get it from the github repository
Configure your Csound command (e.g. <CsOptions>)
The default settings in <CsOptions> use the default audio device (dac) for realtime output, and open port 8099 to receive UDP messages for your livecode envionment.
Adjust or replace this for any specific settings used your csound command.
Add an instrument library?
When present, the commandline flag --omacro:SOUNDLIB=<your .orc file> will load another csound document from your $INCDIR path after cslc has been set up. Useful if you have some pre-built instruments ready for your performance.
Usage
Use named instruments rather than numbers. Many UDO's in cslc rely on instrument names rather than numbers.
Almost all cslc UDO's run at init-time. This allows them to be evaluated in csound global space (outside instrument definitions)
If you do use numbered instruments, avoid instrument numbers i1 through to i10, i299, and i301.