supercollider-tmbundle/README.textile

h1. "textmate-supercollider":http://github.com/rfwatson/textmate-supercollider

A "SuperCollider":http://supercollider.sourceforge.net bundle for "TextMate":http://www.macromates.com.

!http://farm4.static.flickr.com/3214/3005708965_4b6122cc66.jpg!:http://farm4.static.flickr.com/3214/3005708965_4b6122cc66_b.jpg

h2. Requirements

A "recent build":http://sourceforge.net/projects/supercollider of SC (>= 3.3 alpha)

h2. Installation

h3. With git

* @mkdir -p ~/Library/Application\ Support/TextMate/Bundles@
* @cd ~/Library/Application\ Support/TextMate/Bundles@
* @git clone git://github.com/rfwatson/supercollider-tmbundle.git "SuperCollider.tmbundle"@
* @osascript -e 'tell app "TextMate" to reload bundles'@

h3. Without git

* @mkdir -p ~/Library/Application\ Support/TextMate/Bundles@
* @cd ~/Library/Application\ Support/TextMate/Bundles@
* @wget http://github.com/rfwatson/supercollider-tmbundle/tarball/master@
* @tar zxf rfwatson-supercollider-tmbundle*.tar.gz@
* @rm rfwatson-supercollider-tmbundle*.tar.gz@
* @mv rfwatson-supercollider-tmbundle* SuperCollider.tmbundle@
* @osascript -e 'tell app "TextMate" to reload bundles'@

h3. After installing

* Open TextMate and select 'SuperCollider' bundle
* Press CMD-SHIFT-F1 to complete installation.

h2. Key controls

* @ENTER@<br/>Execute current selection/line

* @CTRL-PERIOD@<br/>
Stop server

* @CMD-k@<br/>
recompile class library

* @CMD-d@<br/>
Help

* @CMD-j@<br/>
Open class definition

* @CMD-y@<br/>
Implementations of

* @CMD-Y@<br/>
References to

* @CMD-?@<br/>
Post window to front

* @CMD-SHIFT-C@<br/>
Clear post window

* @CMD-ALT-CTRL-S@<br/>
Switch to SuperCollider mode

<br/>
*plus* various snippets - check the bundle.

h2. Limitations

TextMate does not handle .rtf documents. So .rtf files will have to be copy-and-pasted into .sc text files. This is not a problem for classes.

CMD-period cannot be programmed in TextMate, so to stop audio output use CTRL-period instead

Class lib can only currently be recompiled from within TextMate (CMD-K) if there's been no previous error compiling it. Recompile from within SC in that case

h2. Notes

I've extracted the underlying code to allow control of SC.app from any command line application.<br/>"sc3ctrl on github":http://github.com/rfwatson/sc3ctrl

h2. Contact me

Via "github":http://github.com/rfwatson