File	Date	Author	Commit
Help	2007-11-01	Ryan Brown	[b5f351] Huge aesthetic improvements for the main help file
SCClassLibrary	2007-11-01	Dan Stowell	[396096] Fix bug in mouse click handling for Help.gui
examples	2007-10-31	Nick Collins	[2d7e8d] Added three extra contribution example patches
plugins	2007-06-12	Ryan Brown	[0b2d75] universal -> trunk
sounds	2007-09-24	Scott Wilson	[7e7139] Fixed DC offset
.cvsignore	2007-06-12	Ryan Brown	[0b2d75] universal -> trunk
ChangeLog	2007-11-01	Ryan Brown	[a18252] Renamed ChangeLog.scd to ChangeLog
README	2007-10-31	Nick Collins	[9ff074] Multiple Help alterations

Read Me

Welcome to SuperCollider 3! 

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 (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.sourceforge.net/



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. Within the SuperCollider application directory you will find a Help directory containing HTML files which you can browse in a web browser or within SuperCollider itself. 

The exact details of using the SuperCollider environment will depend on your platform. Some immediate comments: 

1) SuperCollider is really two applications: a sound synthesiser (the Server), and a programming language (the Lang) with its own developer environment. You can use both of these or one or the other. When using SC (SuperCollider) from within the developer environment SC Lang, the SC Server is used automatically for sound synthesis as long as it's turned on! This is accomplished by pressing the 'Boot' button on a Server graphic or running the code s.boot. Further details are in the help tutorials; but we're just warning you now in case you're impatient and can't understand why you're not immediately getting sounds.  

2) The Main Help page in SuperCollider (Help/Help.html) gives some immediate key commands and should be enough to help you start navigating the help system. Please also check the different menu options available with the application on your system. 

Platform specific comments: 

[OS X]  If using a MacIntel machine, you will need to set up an Aggregate Device (under Audio/MIDI Setup) to combine audio in and audio out. In order to run this with SuperCollider, and supposing your Aggregate Device is called 'Agg' execute these two lines of SuperCollider code to prepare then boot a server: 

s.options.device = 'Agg'
s.boot;

To execute a line in OS X, put the cursor on a line and press the Enter key; this is distinct from the Return key! 

And be careful you're not using TextEdit or a web browser instead of
the SuperCollider application when you try to execute code; SC's text
editor interface is a lot like TextEdit, but only the SC editor can
run code when you hit Enter.

   
[Windows] The windows version of SuperCollider is called PsyCollider. Key commands differ from the Mac, but almost all code should work the same. The SwingOSC Java based GUI library is used here, however, for GUIs. You must use JMouseX/JMouseY in particular; PsyCollider does not support MouseX/MouseY UGens.  


[Linux] Most people use SuperCollider from emacs; there are some alternative editors available. For GUI building, the SwingOSC Java framework is a standard option. For more information on Linux specific issues, check the README in the folder linux, and the README in the folder linux/scel for information on the emacs editor.




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

 

SuperCollider 3.1 was released on October 31, 2007