Troubleshooting a Tidal install

From TidalCycles userbase
Revision as of 23:52, 4 January 2019 by Yaxu (talk | contribs)
Jump to: navigation, search

If you've gone through the Tidal installation instructions, but can't get it working, here's some steps to locate what the problem is (or problems are).


Open a terminal window, and type:


You should see something like this

 GHCi, version 8.6.3:  :? for help

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 back to 7.10.3.

Tidal library

Keeping that ghci window open, type (or paste in):

 import Sound.Tidal.Context

You should now see something like:

 GHCi, version 8.6.3:  :? for help
 Prelude> import Sound.Tidal.Context
 Prelude Sound.Tidal.Context> 

If you instead see an error message like:

 <no location info>: error:
   Could not find module ‘Sound.Tidal.Context’

This means that the tidal library isn't installed. To install it, open a new terminal window and type:

 cabal update; cabal install tidal

If you see an error message (ignoring warnings about 'legacy v1 style' commands), then make sure you have installed the 'full' haskell platform and try again. If it still doesn't work, please make a note of the error message and ask the Community for help.

SuperCollider / SuperDirt

Start SuperCollider, and paste the following in:


With your cursor on the same line, run it with shift-enter.

You should see messages about lots of sample banks being loaded and eventually:

 SuperDirt: listening to Tidal on port 57120

If you instead see an error message, read on..

ERROR: Class not defined.

If you see the error

 ERROR: Class not defined.

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.

Could not bind to requested port

If you see an error like:

 Could not bind to requested port. This may mean it is in use already by another application.
 ERROR: Could not open UDP port 57120

This probably means you have stray supercollider processes running, blocking network ports. Shut down supercollider, and force quit `sclang` and `scserver` in your task manager. Failing that, a reboot will clear them.