Installation¶

Get SuperCollider¶

Supriya uses SuperCollider as its synthesis engine. SuperCollider is available on OSX, Linux and Windows (although Supriya has not been tested on Windows).

You can download SuperCollider from http://supercollider.github.io/.

Get Supriya¶

Install Supriya from its GitHub repository, via git and pip:

~$ git clone https://github.com/supriya-project/supriya.git
~$ cd supriya
supriya$ pip install -e .

Optional dependencies¶

With Sphinx and IPython support:

supriya$ pip install -e .[docs]

With linting and testing dependencies:

supriya$ pip install -e .[test]

Graphviz¶

Supriya uses Graphviz, an open-source graph visualization library, to create graphs of rhythm-trees and other tree structures, and to create visualizations of class hierarchies for its documentation. Graphviz is not necessary for making sounds with Supriya.

To install Graphviz on Debian and Ubuntu:

~$ sudo apt-get install graphviz

To install Graphviz on OSX via Homebrew:

~$ brew install graphviz

Once you have install Graphviz, test if Graphviz is callable from your command-line by running the following command:

~$ dot -V
dot - graphviz version 2.38.0 (20140413.2041)