README.textile

April 25, 2009 ยท View on GitHub

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@
    Execute current selection/line

  • @CTRL-PERIOD@
    Stop server

  • @CMD-k@
    recompile class library

  • @CMD-d@
    Help

  • @CMD-j@
    Open class definition

  • @CMD-y@
    Implementations of

  • @CMD-Y@
    References to

  • @CMD-?@
    Post window to front

  • @CMD-SHIFT-C@
    Clear post window

  • @ALT-CTRL-SHIFT-S@
    Switch to SuperCollider bundle


*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.
"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