You can install TidalCycles on MacOS, Windows, and Linux. Locate the instructions below for your specific operating system.
You first need to install the following three pieces of software, Haskell, Atom, and SuperCollider. You can download them from their websites - click on each of the below:
- Haskell
- Atom
- SuperCollider (version 3.7 or later)
- You may also need to install Git
You will need the SuperCollider sc3-plugins for using many 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. You can install the latest version from github according to the instructions there.
NOTE As of September 26 2017, There appears to be an issue with Cabal that is affecting installation on MacOS.
If you are unable to install TidalCycles with the directions below, please try these alternate installation instructions. From a terminal window, run this:
stack setup stack install tidal
Once that's done, you'll also need to change a configuration setting in Atom. Find the package settings for TidalCycles (preferences > tidalcycles > settings). Change the
'ghci path'option to this:
stack ghc -- --interactive -XOverloadedStrings
Restart Atom and it should be able to start TidalCycles.
Open a Terminal window and type in the following command, to install TidalCycles:
cabal install tidalIf you're unsure how to open a terminal window, in Mac OS it's "Terminal" under Utilities.
Start SuperCollider, and in the editor window paste in the following line of code:
include("SuperDirt")Run the code by clicking on it, to make sure the cursor is on this line, then hold down shift and press enter.
It will download SuperDirt and you will see it has completed when the Post Window displays:
... the class library may have to be recompiled.
-> SuperDirtAfter it has completed, you will need to restart SuperCollider (or alternatively, recompile the class library via the "Language" menu).
If you instead see a message like this:
"ERROR: Quarks requires git to be installed"Then you will need install git from
https://git-scm.com/downloads, and
return to SuperCollider to run include("SuperDirt") again.
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.
You first need to install the following three pieces of software, Haskell, Atom, and SuperCollider. You can download them from their websites - click on each of the below:
- Haskell
- Atom
- SuperCollider (version 3.7 or later)
- You may also need to install Git
Important: Make sure you follow Step 2 of the Haskell installation instructions.
Important: When installing SuperCollider, you must also download the sc3-plugins
zip file. Run SuperCollider once in order to create user directories. Then open
the zip file and extract the SC3plugins directory to
C:\Users\<username>\AppData\Local\SuperCollider\Extensions. You may have to
manually create the Extensions directory. Restart SuperCollider so that it finds
the SC3plugins directory.
Open a Terminal window and type in the following command, to install TidalCycles:
cabal install tidalIf you're unsure how to open a terminal window: in Windows it's "command prompt" under Accessories
Start SuperCollider, and in the editor window paste in the following line of code:
include("SuperDirt")Run the code by clicking on it, to make sure the cursor is on this line, then hold down shift and press enter.
It will download SuperDirt and you will see it has completed when the Post Window displays:
... the class library may have to be recompiled.
-> SuperDirtAfter it has completed, you will need to restart SuperCollider (or alternatively, recompile the class library via the "Language" menu).
If you instead see a message like this:
"ERROR: Quarks requires git to be installed"Then you will need install git from
https://git-scm.com/downloads, and
return to SuperCollider to run include("SuperDirt") again.
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.
You first need to install the following three pieces of software, Haskell, Atom, and SuperCollider. You can download them from their websites - click on each of the below:
- Haskell
- Atom
- SuperCollider (version 3.7 or later)
- You may also need to install Git
You need the SuperCollider
sc3-plugins for using many 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. You can either install the
latest version from
github according to
the instructions there, or you may find it
in your package manager. On Fedora the package is called
supercollider-sc3-plugins.
Open a Terminal window and type in the following command, to install TidalCycles:
cabal install tidalIf you're unsure how to open a terminal window in Linux, it varies according to distribution but generally find "Terminal" in the menus).
Start SuperCollider, and in the editor window paste in the following line of code:
include("SuperDirt")Run the code by clicking on it, to make sure the cursor is on this line, then hold down shift and press enter.
It will download SuperDirt and you will see it has completed when the Post Window displays:
... the class library may have to be recompiled.
-> SuperDirtAfter it has completed, you will need to restart SuperCollider (or alternatively, recompile the class library via the "Language" menu).
If you instead see a message like this:
"ERROR: Quarks requires git to be installed"Then you will need install git from
https://git-scm.com/downloads, and
return to SuperCollider to run include("SuperDirt") again.
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.