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)

"TextMate":http://macromates.com, with terminal usage enabled (see Help -> Terminal Usage in TM menu)

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'@

In Textmate menu: Bundles > SuperCollider > Complete installation



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'@

In Textmate menu: Bundles > SuperCollider > Complete installation


h2. Key controls

All key controls can be reprogrammed in Bundles editor.

* @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

* @ALT-CTRL-SHIFT-S@<br/>
Switch to SuperCollider bundle

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

h2. Notes

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.

Some controls (browse class file, etc) depend upon TM terminal command (see Help -> Terminal Usage in TM menu)

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

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. TODO

Might repackage this as a quark .. ?

h2. Contact me

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