Difference between revisions of "Linux installation"

From TidalCycles userbase
Jump to: navigation, search
(Created page with "== Prerequisites == The following are required: * [https://www.haskell.org/platform/ Haskell Platform] - the Full platform is recommended. Advanced users may try using the C...")
 
Line 1: Line 1:
== Prerequisites ==
+
= Prerequisites =
  
 
The following are required:
 
The following are required:
Line 17: Line 17:
  
 
* [https://supercollider.github.io/sc3-plugins/ 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.
 
* [https://supercollider.github.io/sc3-plugins/ 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 =
 +
 +
Open a Terminal. If you’re unsure how to open a terminal window in Linux, it varies according to distribution but generally find “Terminal” in the menus. Then type and run these two commands:
 +
 +
cabal update
 +
cabal install tidal
 +
 +
 +
If you've never installed TidalCycles before, then the <code>cabal install tidal</code> step may take some time. At the end of the command output, it should say <code>Installed tidal-x.x.x</code> (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:
 +
 +
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. 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.
 +
 +
== Test Your Installation ==
 +
 +
Now you are ready to [[start_tidalcycles_and_superdirt_for_the_first_time|Start TidalCycles and SuperDirt for the first time]].

Revision as of 16:12, 14 November 2018

Prerequisites

The following are required:

Hopefully your Linux distribution makes these easily available to you via a package manager. For example, if you are using recent version of Ubuntu or similar, you can install supercollider and haskell with the following command in a terminal window:

sudo apt-get install supercollider sc3-plugins cabal-install git

Make sure the supercollider version is 3.7 or later. If it isn’t available in your Linux distribution, then you may have to compile a newer version yourself, or upgrade your distribution.

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.

Install TidalCycles

Open a Terminal. If you’re unsure how to open a terminal window in Linux, it varies according to distribution but generally find “Terminal” in the menus. Then 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.

Install SuperDirt

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

Test Your Installation

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