Skip to content
A programming language for real time audio synthesis and algorithmic composition.
C++ SuperCollider C HTML CMake Python Other
Find file
Latest commit 6d36ae7 Apr 26, 2016 @crucialfelix crucialfelix Merge pull request #2004 from llloret/tutorials_spell_fix
help: fix spelling in tutorials
Failed to load latest commit information.
HelpSource Merge pull request #2004 from llloret/tutorials_spell_fix Apr 26, 2016
QtCollider cmake: library locations, hide them from the default listing of user … Apr 14, 2016
SCClassLibrary class library: warning in node proxy, add newlines Apr 24, 2016
SCDoc scdoc/sclang lexers: use intptr_t for compatibility with LLP64 archit… Dec 7, 2015
cmake_modules Win: Remove accidental leftovers from FindPortaudio Mar 30, 2016
common sclang: introduce unixCmd for array of arguments Feb 8, 2016
editors Replace built-in scvim with submodule scvim Apr 23, 2016
examples examples: spaces to tabs, remove trailing white space Jan 15, 2016
external_libraries Merge pull request #1971 from bagong/pa-hash Apr 15, 2016
icons scapp: remove scapp Aug 20, 2013
include Merge branch '3.7' into topic/merge-3.7 Mar 16, 2016
lang Merge pull request #1972 from supercollider/reimplement-matchLangIP Apr 19, 2016
package build: fix typo in packager-script help string Feb 4, 2016
platform Handle translations properly in target scide and some cleanup Mar 16, 2016
server Merge pull request #1947 from sonoro1234/portaudio_backend_elif Apr 20, 2016
sounds source tree reorganization Nov 30, 2010
testsuite supernova: tests - use thread and chrono Dec 28, 2015
.gitignore Revert "Ignore build folders" Oct 5, 2014
.gitmodules Replace built-in scvim with submodule scvim Apr 23, 2016
.travis.yml travis: move git key to env, aws fixes Apr 20, 2016
AUTHORS updated News-3.7.schelp, CHANGELOG and AUTHORS Mar 13, 2016
CHANGELOG.md Version 3.7.1 Apr 10, 2016
CMakeLists.txt Merge pull request #1968 from danstowell/topic/mark_as_advanced Apr 18, 2016
COPYING enable GPL3 code by default Jan 24, 2010
ChangeLog new generated CHANGELOG.md Jan 18, 2016
INSTALL Update INSTALL Jan 24, 2014
README.md readme: add a build status badge. Apr 2, 2016
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 Show how to list build options in the README Apr 14, 2016
README_OS_X.md Merge pull request #1965 from vivid-synth/cmake_options_in_readme Apr 24, 2016
README_WINDOWS.md Win: Adjust Readme to new required compiler version Mar 27, 2016
SCVersion.txt bump version to 3.8dev Mar 16, 2016
build_sclang.cfg.in build entire BUILD_CLASSLIBRARYPATH in cmake instead of having one va… Mar 20, 2011

README.md

Build Status

Welcome to SuperCollider!

SuperCollider is an environment and programming language for real time audio synthesis and algorithmic composition. It provides an interpreted object-oriented language which functions as a network client to a state of the art, realtime sound synthesis server.

SuperCollider was written by James McCartney (http://audiosynth.com) over a period of many years. It is now an open source GPL'd project maintained and developed by James and various others. It is used by musicians, scientists, and artists working with sound.

http://supercollider.github.io/

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.

Usage

SuperCollider consists of three separate components:

  1. scsynth - 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:

http://www.birmingham.ac.uk/facilities/ea-studios/research/supercollider/mailinglist.aspx

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.

https://github.com/supercollider/supercollider/issues

Building the Source Code

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

License

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 October 31, 2007
  • SuperCollider 3.2 was released on February 19, 2008
  • SuperCollider 3.3 was released on April 30, 2009
  • SuperCollider 3.4 was released on July 15, 2010
  • SuperCollider 3.5 was released on March 16, 2012
  • SuperCollider 3.6 was released on November 28, 2012
  • SuperCollider 3.7 was released on March 13, 2016

Outro

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

Something went wrong with that request. Please try again.