Difference between revisions of "Windows installation"

From TidalCycles userbase
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
 
<translate>
 
<translate>
= Prerequisites = <!--T:1-->
 
  
== Required Prerequisites== <!--T:2-->
+
= Easy install =
 +
 
 +
For an easy, automated install experience, see the [[Windows choco install]].
 +
 
 +
= Manual install =
 +
 
 +
If you prefer to install the different parts of a Tidal environment by hand, perhaps because you already have supercollider or haskell installed, then follow the below instructions.
 +
 
 +
== Prerequisites == <!--T:1-->
 +
 
 +
=== Required Prerequisites=== <!--T:2-->
  
 
<!--T:3-->
 
<!--T:3-->
Line 8: Line 17:
  
 
<!--T:4-->
 
<!--T:4-->
* [https://www.haskell.org/platform/windows.html Haskell Platform] - Please note! There's a bug in the windows haskell installer, please install [https://www.haskell.org/platform/download/8.4.3/HaskellPlatform-8.4.3-full-x86_64-setup.exe this version] (Haskell 8.4.3 'full' install) and it should work
+
* Haskell Platform - Please note! There's a bug in the windows haskell installer, please install [https://www.haskell.org/platform/download/8.4.3/HaskellPlatform-8.4.3-full-x86_64-setup.exe this version] (Haskell 8.4.3 'full' install) and it should work
 
* [https://atom.io/ Atom Editor]  (if you don't like the atom editor for some reason, please check out the [[List of tidal editors|list of alternatives]])
 
* [https://atom.io/ Atom Editor]  (if you don't like the atom editor for some reason, please check out the [[List of tidal editors|list of alternatives]])
 
* [http://supercollider.github.io/download SuperCollider] (pick the latest version)
 
* [http://supercollider.github.io/download SuperCollider] (pick the latest version)
 
* [https://git-scm.com/ Git]
 
* [https://git-scm.com/ Git]
  
== Optional Prerequisites == <!--T:5-->
+
=== Optional Prerequisites === <!--T:5-->
  
 
<!--T:6-->
 
<!--T:6-->
Line 21: Line 30:
 
* [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 = <!--T:8-->
+
== Install TidalCycles == <!--T:8-->
  
 
<!--T:9-->
 
<!--T:9-->
Line 35: Line 44:
 
If you see an error with the network library, then you need to fix something with your Haskell install. You can [https://forum.toplap.org/t/trouble-launching-tidal-in-atom/678/3 find instructions here].
 
If you see an error with the network library, then you need to fix something with your Haskell install. You can [https://forum.toplap.org/t/trouble-launching-tidal-in-atom/678/3 find instructions here].
  
= Install SuperDirt = <!--T:12-->
+
== Install SuperDirt == <!--T:12-->
  
 
<!--T:13-->
 
<!--T:13-->
Line 64: Line 73:
 
</source>
 
</source>
  
= Install Atom Extension = <!--T:18-->
+
== Install Atom Extension == <!--T:18-->
  
 
<!--T:19-->
 
<!--T:19-->
 
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.
 
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 = <!--T:20-->
+
== Test Your Installation == <!--T:20-->
  
 
<!--T:21-->
 
<!--T:21-->
 
Now you are ready to [[Start_tidalcycles_and_superdirt_for_the_first_time|Start TidalCycles and SuperDirt for the first time]].
 
Now you are ready to [[Start_tidalcycles_and_superdirt_for_the_first_time|Start TidalCycles and SuperDirt for the first time]].
 
</translate>
 
</translate>

Latest revision as of 07:56, 9 October 2019

Easy install

For an easy, automated install experience, see the Windows choco install.

Manual install

If you prefer to install the different parts of a Tidal environment by hand, perhaps because you already have supercollider or haskell installed, then follow the below instructions.

Prerequisites

Required Prerequisites

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

  • Haskell Platform - Please note! There's a bug in the windows haskell installer, please install this version (Haskell 8.4.3 'full' install) and it should work
  • Atom Editor (if you don't like the atom editor for some reason, please check out the list of alternatives)
  • SuperCollider (pick the latest version)
  • Git

Optional Prerequisites

The following is optional, but 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

Open a Command Prompt (or PowerShell), 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.

If you see an error with the network library, then you need to fix something with your Haskell install. You can find instructions here.

Install SuperDirt

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

Quarks.checkForUpdates({Quarks.install("SuperDirt", "v1.1.1"); thisProcess.recompile()})

Run the code by clicking on it, to make sure the cursor is on this line, then hold down Shift and press Enter.

It'll take a while to install. You'll see something like the following:

Installing SuperDirt
Installing Vowel
Vowel installed
Installing Dirt-Samples
Dirt-Samples installed
SuperDirt installed
compiling class library...
...
(then some blah blah, and finally, something like:)
...

*** Welcome to SuperCollider 3.10.0. *** For help press Ctrl-D.

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.