Atom package for TidalCycles, a language for live coding pattern.







This package provides the following services:

TidalCycles plugin for Atom


TidalCycles is a live-coding pattern language

After TidalCycles installation (checkout official documentation for details),

Then, you can:

To send patterns to SuperDirt, use d1 .. d9, e.g.:

d1 $ sound "bd cp"



You can choose between 3 Haskell interpreters:

Haskell Path

By default the plugin will use the ghci and ghc-pkg binaries in $PATH configuration.

You can configure your Haskell binary folder to use a different version of it. (Only works with Default interpreter)

Boot Tidal Path

The plugin will load the BootTidal.hs file according to this sequence:


SuperDirt can be started automatically at the first tidal code evaluation. The plugin will use a superdirt_startup.scp if it's present into the current folder, otherwise it will use the default startup command. This feature can be disabled in configuration.


You can turn on/off autocomplete with flag.

Documentation details with Hoogle

With hoogle the autocomplete experience will improve and official tidal documentation will be shown.

Install hoogle and set the Hoogle Path configuration (by default it's already hoogle) if you install it with stack, add two dashes at the end of the property (e.g. stack hoogle --).

After installation you have to generate tidal documentation, in your terminal run:
hoogle generate tidal
stack hoogle -- generate tidal (with stack)

Console Prompt

Customize the console prompt with a string. Placeholders can be used, e.g.

eval #%ec

will prompt:

eval #1>
eval #2>


Osc Eval

It's possibile to evaluate tidal code from OSC messages.


The atom plugin is listening on this specified port for incoming osc messages.


The atom plugin ist listenting on this ip address for incoming osc messages.


The atom plugin is filtering incoming osc messages with this specified address.



Mandatory type argument to specify what kind of evaluation is requested:

  1. line (evaluate single line)
  2. multi_line (evaluate code block)
  3. whole_editor (evaluate all the editor)
Row / Column

row and column parameters can be specified to move the cursor on that position before the evaluation.

Sound Browser

To make the sound browser at the first tidal evaluation, add your paths to the Sound Browser Folders in the plugin configuration, separed by commas.
Restart atom to apply changes.

Other configurations


Some flags have not been recognized: prompt-cont

The GHC version is too old (like 8.0.3). Solutions:

'' is not recognized as an internal or external command, operable program or batch file.

The BootTidal.hs and ghci path cannot contains whitespace inside. Solutions:

Note: there's a fix coming in GHC version 8.12

Could not find module Sound.Tidal.Context

The BootTidal.hs file is loaded correctly, but tidal is not installed. Install it before following the official guide:


If you'd like to contribute to this package, here are some guidelines:

JavaScript Formatting

A .jsbeautifyfc file is used to define JavaScript formatting settings. Please use a beautifier package (we recommend atom-beautify) to format your changes with these settings.


Always run specs before PR.
On Atom, execute the Window: Run Package Specs command (ctrl+shift+y).
0 failures should be the result