kitefishlabs / cbpsc Goto Github PK

cbpsc
=====

Corpus-based Processing for SuperCollider.

© 2010-2013, Tom Stoll, released under the terms of GPL v.3, all rights reserved. Please see COPYING for a copy of the license.

cbpsc is beta software. I (Tom Stoll) have been testing it and fixing bugs for several months and am working towards a 1.0 release. That said, you may encounter bugs and/or undocumented features.

cbpsc has been tested with SC-0.3.6 extensively and exclusively on the Mac platform. It uses a quark that is not in the included classes: "KDTree". Analysis Synthdefs also rely on two MCLD UGens.

To install:

  1. Unzip the archive or clone the Git repo.
  2. Drag the .sc files to your Extensions folder (~/Library/Application Support/SuperCollider/Extensions or /Library/Application Support/SuperCollider/Extensions).
  3. Recompile sclang (apple-K).

To Install KDTree:

  1. Evaluate "Quarks.gui".
  2. When the window appears, select "KDTree", "TabbedView", and "XML". Their buttons should turn blue and change from "-" to "+".
  3. Click the "Save" button at the top right.
  4. Don't forget to recompile the library (apple-K).

Where to start? Look at the tutorials and help classes. Look at the classes themselves. A growing amount of documentation can be found at http://www.kitefishlabs.com. 


KNOWN ISSUES (as of version 1.0 (beta) -- May 2013)

These are a few things you might encounter. They will all hopefully be fixed as soon as possible.

1. Watch the Server GUI when importing large amounts of audio data. It may turn itself 'inactive' at times when under a heavy computational load. You must wait a few seconds until the Server is active to continue using the GUI without errors.

2. The GUI code is released as *historical* code. It mostly works, but would require some tweaks to make it current with the latest code in the main classes. I will get to this this fall, but let me know if this is something that you are interested in.

3. Many updates and new/reworked features implemented in the Python version have now been back-ported to the SC version. These revolve around "child" nodes in sound file trees, and other structural aspects.


TEST SOUND SET

I have included in the GIT repo two audio files used in the tutorial code. These files are known to work with CBPSC.

CONTACT

Email me (Tom Stoll) with questions: [email protected]