LinuxCommandLibrary

supercollider

TLDR

Start the SuperCollider interpreter

$ sclang
copy
Run a SuperCollider script
$ sclang [script.scd]
copy
Start in daemon mode (no input)
$ sclang -D
copy
Run Main.run on startup
$ sclang -r [script.scd]
copy
Set initial heap size
$ sclang -m [8m]
copy
Set UDP listening port
$ sclang -u [57120]
copy
Set runtime directory
$ sclang -d [/path/to/runtime]
copy

SYNOPSIS

sclang [options] [file]

DESCRIPTION

sclang is the SuperCollider programming language interpreter. SuperCollider is a platform for audio synthesis and algorithmic composition, used by musicians, artists, and researchers for real-time audio processing and sound design.
The interpreter acts as a client for scsynth, the SuperCollider audio synthesis server. It interprets SuperCollider code and sends OSC (Open Sound Control) messages to the synthesis server to control audio generation.
SuperCollider scripts (.scd files) can be executed directly from the command line for headless audio processing or batch operations. The daemon mode allows running SuperCollider without a terminal for server deployments.
On Linux, sclang can run without a display server by setting the environment variable QTQPAPLATFORM=offscreen.

PARAMETERS

-d path

Set runtime directory.
-D
Enter daemon mode (no user input).
-g size
Set heap growth size (default 256k). Suffix with k or m.
-h
Display help information.
-l path
Set library configuration file.
-m size
Set initial heap size (default 2m). Suffix with k or m.
-r
Call Main.run on startup.
-s
Call Main.stop on shutdown.
-u port
Set UDP listening port (default 57120).

CAVEATS

Requires scsynth audio server for audio synthesis. The SuperCollider IDE provides a more integrated development experience. Script files must be structured as single executable blocks when run from command line. Memory settings may need tuning for complex compositions.

HISTORY

SuperCollider was developed by James McCartney starting in 1996. It was initially proprietary software for Macintosh but was released as free software under the GPL in 2002. The language has become a standard tool in the computer music community, used for live coding performances and academic research.

SEE ALSO

scsynth(1), jack(1), csound(1), puredata(1)

Copied to clipboard