C++ SuperCollider C HTML CMake Python Other
Latest commit cd14eaf Feb 20, 2017 @telephon telephon committed on GitHub Merge pull request #2720 from bagong/fix_win_build
Fix symlinks in win build system
Failed to load latest commit information.
.travis travis: fix lint script path Oct 24, 2016
HelpSource VDiskIn.schelp: formatting & capitalization Feb 11, 2017
QtCollider Qt gui: Allow TextView selectedString_ to work if selection size is 0 Jan 16, 2017
SCClassLibrary class library: move overwriting extension to supress warning Feb 16, 2017
SCDoc scdoc/sclang lexers: use intptr_t for compatibility with LLP64 archit… Dec 7, 2015
cmake_modules build: fix qt "Plugins" configuration for case-sensitive OS X (#2262) Aug 10, 2016
common Avoid breaking VS build. Feb 6, 2017
editors Merge pull request #2708 from bagong/winjunctions Feb 14, 2017
examples examples: fix sound Jan 18, 2017
external_libraries Update pointers to sudbmodules hidapi and portaudio related to winbuild Feb 13, 2017
icons move SVG logo from HelpSource/images to icons (#2312) Aug 30, 2016
include Couple tiny typo fixes Jan 2, 2017
lang Fix symlinks in win build system Feb 20, 2017
package Fix OS X readme references in package generator and cmake Feb 11, 2017
platform Fix symlinks in win build system Feb 20, 2017
server Win: let SC use portaudio package in case of MSYS(2) build Feb 7, 2017
sounds source tree reorganization Nov 30, 2010
testsuite testsuite: add OffsetOut and fix naming Feb 2, 2017
.editorconfig lint: classlib - convert SCDocRenderer.sc to tabs Aug 20, 2016
.gitignore Add ASIO SDK folder to gitignore Feb 7, 2017
.gitmodules Switch to hidapi subomodule in sc org repo May 20, 2016
.travis.yml travis: set QT_PREFIX and QT_PLUGIN_PATH for QT builds Sep 5, 2016
AUTHORS updated News-3.7.schelp, CHANGELOG and AUTHORS Mar 13, 2016
CHANGELOG.md Update CHANGELOG Nov 8, 2016
CMakeLists.txt Merge pull request #2704 from bagong/winmsys Feb 13, 2017
COPYING enable GPL3 code by default Jan 24, 2010
ChangeLog new generated CHANGELOG.md Jan 18, 2016
INSTALL readme: rename OS X to macOS Feb 11, 2017
README.md Readme: update link to macOS readme Feb 11, 2017
README_IPHONE.md README files: Keep universal information in the main README, Jan 15, 2016
README_JAILBROKEN_IPHONE.md README: remove all language identifiers from code blocks Jul 1, 2013
README_LINUX.md linux readme: add note about ".." Jan 8, 2017
README_MACOS.md Merge branch 'master' into topic/rename-os-x Feb 11, 2017
README_WINDOWS.md Update/rewrite Windows readme Feb 13, 2017
SCVersion.txt Bump Version 3.9dev Nov 8, 2016
build_sclang.cfg.in build entire BUILD_CLASSLIBRARYPATH in cmake instead of having one va… Mar 20, 2011
travis_test_run_proto.json Add CommonTests and CommonTestsGUI to travis (#1967) May 4, 2016


Build Status

Welcome to SuperCollider!

SuperCollider is a platform for audio synthesis and algorithmic composition, used by musicians, artists, and researchers working with sound. It is free and open source software available for Windows, macOS, and Linux.

SuperCollider features three major components:

  • scsynth, a real-time audio server, forms the core of the platform. It features 400+ unit generators ("UGens") for analysis, synthesis, and processing. Some of the audio techniques it supports include additive synthesis, subtractive, FM, granular, FFT, and physical modelling. You can write your own UGens in C++, and users have already contributed several hundred more to the sc3-plugins repository.
  • sclang, an interpreted programming language, controls scsynth via Open Sound Control. You can use sclang for algorithmic sequencing, connecting your app to external hardware including MIDI controllers, or writing GUIs and visual displays. sclang has a stock of user-contributed extensions called Quarks.
  • scide is an editor for sclang with an integrated help system.

SuperCollider was developed by James McCartney and originally released in 1996. In 2002, he generously released it as free software under the GNU General Public License. It is now maintained and developed by an active and enthusiastic community.


This README is a first help for anyone new to SuperCollider. There are many good resources available for learning SuperCollider, with up to date links from the site listed above, including links to forums and mailing lists.


SuperCollider consists of three separate components:

  1. scsynth or supernova - audio engine (the "server")
  2. sclang - programming language runtime interpreter including Qt graphical user interfaces
  3. IDE (integrated development environment) - an editor for writing code and running supercollider

To begin using SuperCollider, you usually start up the IDE:

  • on Mac OS this is SuperCollider.app
  • on Linux and Windows, this is the scide executable

You can get further help by using the IDE's integrated help system which can be invoked via the "Help" menu or using the key combination Ctrl+D (on Linux, Windows) or Cmd+D (on Mac OS). In the Help menu, you will also find an action that will take you directly to the help page on using the IDE.

When starting the SuperCollider IDE, the audio server is not started automatically. You can start it using the "Language > Boot Server" menu action, or using the key combination Ctrl+B (on Linux, Windows) or Cmd+B (on Mac OS). This is just to remind you in case you're impatient and can't understand why you're not immediately getting sound.

We suggest you to proceed by reading the tutorials available in the help system. Please note that some help pages are not up-to-date with the latest development of SuperCollider, especially when mentioning the code editing environment. Regarding this, it is best to refer to the help page specifically about the new SuperCollider IDE.

Also, please explore the IDE menus, which will let you discover a lot of functionality of the coding environment.

To get further information on SuperCollider usage or development, you should subscribe to the mailing lists:


We hope you enjoy SuperCollider; please get involved in the active community!

Reporting bugs

Please report bugs to the github issue tracker or discuss on the sc-users mailing list.


Building the Source Code

Platform specific build and install instructions can be found in the following files:


SuperCollider is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. See COPYING for the license text.

  • SuperCollider 3.1 was released on 2007-10-31
  • SuperCollider 3.2 was released on 2008-02-19
  • SuperCollider 3.3 was released on 2009-04-30
  • SuperCollider 3.4 was released on 2010-07-15
  • SuperCollider 3.5 was released on 2012-03-16
  • SuperCollider 3.6 was released on 2012-11-28
  • SuperCollider 3.7 was released on 2016-03-13
  • SuperCollider 3.8 was released on 2016-11-04


Thanks to James McCartney, for making this great piece of audio software publicly and freely available!