The following are required:
- Haskell Platform - the Full platform is recommended. Advanced users may try using the Core platform.
- Atom Editor
- SuperCollider (version 3.7 or later)
The following are optional:
- SC3 Plugins - you may need the SuperCollider sc3-plugins if you want to use any of the synths included in SuperDirt. Most of the examples in the documentation will still work, so you could skip this step and return to it later.
From a terminal, type and run these two commands:
cabal update cabal install tidal
If you've never installed TidalCycles before, then the
cabal install tidal step may take some time. At the end of the command output, it should say
Installed tidal-x.x.x (where x.x.x is the latest version number) without any errors.
Start SuperCollider, and in the editor window paste in the following line of code:
Run the code by clicking on it, to make sure the cursor is on this line, then hold down Shift and press Enter. This will download SuperDirt and you will see it has completed when the Post Window displays:
... the class library may have to be recompiled. -> SuperDirt
After it has completed, you will need to restart SuperCollider (or alternatively, recompile the class library via the “Language” menu).
Install Atom Extension
Start Atom, and install the TidalCycles plugin. You can find it via the menus under edit > settings > install, then typing “tidalcycles” into the search box. Once that’s installed, restart atom.
Testing Your Installation
There are two steps to starting TidalCycles each time:
1) start SuperDirt inside SuperCollider 2) start TidalCycles inside Atom
To start SuperDirt, paste the following code into a SuperCollider window, click on the code, hold down shift and press enter.
Start TidalCycles inside Atom
Start Atom, then create a new file and save it with a filename that ends in .tidal, e.g. test.tidal. Then open the Packages menu and select TidalCycles -> Boot TidalCycles. A small window will open at the bottom of the window and display some text to tell you that the GHCi interpreter is running. Try running a simple pattern by typing in the code below and holding down shift and pressing enter to evaluate it (Holding down control and pressing enter will also work, this evaluates multiple lines).
d1 $ sound "bd sn"
If you hear sound, then your installation is working!