MacOS installation

From TidalCycles userbase
Revision as of 20:47, 21 August 2019 by Yaxu (talk | contribs)
Jump to: navigation, search

Automated Installation with TidalBootstrap

Unfortunately the tidal-bootstrap automated install is no longer working. Please get in touch via the chat or forum if you can help fix it.

Manual Installation

Prerequisites

Required Prerequisites

Before installing Tidal, make sure the following are installed first:

Optional Prerequisites

The following is optional, but highly recommended:

  • 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.

Install TidalCycles

From a terminal, type and run these two commands (ignoring any complaints that cabal has of 'legacy v1 style of usage'):

 cabal update
 cabal install tidal

If you installed haskell with 'ghcup', then you may get command not found errors above. In that case, you try this instead:

 ~/.ghcup/bin/cabal update
 ~/.ghcup/bin/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.

Install SuperDirt

Start SuperCollider, and in the editor window paste in the following line of code:

   Quarks.checkForUpdates(); Quarks.install("SuperDirt", "v1.0")

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.

If you installed the haskell platform with 'ghcup', then there's a setting you'll need to change in the atom tidalcycles package. Change the "ghci path" setting to the following: ~/.ghcup/bin/ghci

Once that’s all installed and configured, restart atom.

Test Your Installation

Now you are ready to Start TidalCycles and SuperDirt for the first time.