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