Open a terminal window, and type:
You should see something like this:
If you don't see something like the above, you probably need to install Haskell. You might well see a different version number, don't worry. At the time of writing, Tidal is tested against versions right back to 7.10.3.
Keeping that ghci window open, type (or paste in):
You should now see something like:
If you instead see an error message like:
This means that the Tidal library isn't installed. To install it, open a new terminal window and type:
Note: as of version 1.7 instead you'll have to use the following commands:
You can ignore warnings about 'legacy v1 style'.
If you still see an error message, then make sure you have installed the Full Haskell Platform and try again. If it still doesn't work, ask help on the Forum or on the Discord or RocketChat.
If you see the following error:
This means SuperDirt isn't installed. Install it by running:
If it fails to install, make sure you have the
git command installed. You can do this by running
git --version from a command prompt. If the command isn't found, then check the install page for how to install Git. Once it's installed, you'll need to restart SuperCollider before trying again.
For users who have just installed SuperCollider, restarting it prior to running
include("SuperDirt") could also resolve the error.
If you see an error like:
This probably means you have stray SuperCollider processes running, blocking network ports. Shut down SuperCollider, and force quit
scserver in your task manager. Failing that, a reboot will clear them.
Supercollider run on a Jack audio server in order to deliver sound to your speakers. If you see the following error in SuperCollider's post window:
You will need to setup Jack with the command:
and add your username to the audio group with (replace USERNAME):
You can check if your username is already in the audio group by typing the command:
You may need to log out and log back in for this to take effect.
You might encounter problems when installing the Tidal Haskell Library. If you encounter errors, the problem might come from the Tidal Haskell library itself. Run the following command to ensure that it is correctly installed:
Sometimes, the installation process can fail without any clear reason. This command can help to fix the problem:
Tidal Cycles is installed with an extensive library of default audio samples. The download can sometimes fail, leaving you without any sound to play. If everything seems to be working, but not all sounds play, then probably there was a problem causing the download of Tidal's sound library to fail part way through.
You can fix this by finding the
Dirt-Samples folder, via the SuperCollider menus: Open
File > Open user Support directory (top-menu). Find the
downloaded-quarks and then the
Dirt-Samples folder. You'll probably find that many of the folders are missing or empty. You can download the missing samples from this link and place them here.
The problem can also come from your sound system. Check that everything is plugged correctly, check if you selected the right audio interface and that the volume is up. If you still don't hear anything, it might come from something else.
If the Tidal Haskell Library has stubborn problems when installed with
cabal, particularly if it brings up errors related to the 'network'
library under library, then instead installing with
stack solves it.
This is done with the following command in a terminal window:
Once that's done, you just have to tell your editor plugin to use the Tidal
stack. In Atom, find the settings for the Tidal Cycles
package, and set the
ghci path setting to:
Restart *Atom** and all should be well.