# SwingOSC -- SuperCollider Classes --

### updating

If you are updating from an existing SwingOSC version, make sure you remove or replace the old class folders. Note that `PenPlus.sc` (SwingOSC up to version 0.43) should also be removed, because it was renamed to `extCocoaCompat.sc`.

Note: A common problem is a mismatch of the version of the Java server and the SuperCollider classes, because it was forgotten to remove the files of previous versions. In this case you should recognize a warning statement in SuperCollider's post window that reads "SwingOSC version mismatch: client is v..., server is v...!".

### supercollider version

SwingOSC v0.59 was successfully tested with SuperCollider 3.2 and should, if possible, not be used with older versions of SuperCollider.

### installation

Copy the content of the `Help` folder to SuperCollider's `Help` folder.
Copy the content of `SCClassLibrary` folder into SuperCollider's `Extensions` folder:

- On Mac OS X, that is either `/Library/Application Support/SuperCollider/SCClassLibrary` (system wide install) or `~/Library/Application Support/SuperCollider/SCClassLibrary` (just for your user account).
- On Linux, that is either `/usr/local/share/SuperCollider/Extensions` (with the default `scons` install) or `/usr/share/SuperCollider/Extensions` (e.g. with `apt-get` on Ubuntu)
- On Windows (Psycollider), that is `SCClassLibrary` inside the main Psycollider folder.

To be able to boot SwingOSC from within SuperCollider, copy the file `SwingOSC.jar` into the main SuperCollider application folder, or set `SwingOSC.program` in your SC startup file to point to the right install location (Note that the prefix `"java -jar"` must not be used any more!). Details about this, and also the possibility to select a particular Java VM, are explained in the `SwingOSC` help file.

### further readings

To get started, please refer to the file `examples/ReadMe-Examples.rtf`.

lastmod: 18-apr-08