Skip to main content

Documentation Reference | Tidal Cycles


Tidal Cycles (or just Tidal for short) is software for making patterns with code, whether live coding music at algoraves or composing in the studio. It includes a simple and flexible notation for rhythmic sequences, and an extensive library of patterning functions for combining and transforming them. This allows you to quickly create complex patterns from simple ingredients.

By default, sound is made with the featureful SuperDirt synth/sampler, but you can control other synths using Open Sound Control (OSC) or MIDI. Whether you're using SuperDirt or a synth, every filter and effect can be manipulated independently with Tidal patterns. Tidal is embedded in the Haskell language, although you don't have to learn Haskell to learn Tidal.

You can learn Tidal through experimentation and play - most Tidal coders have little or no experience in software engineering.


If you enjoy using Tidal Cycles, please consider contributing to the Tidal Cycles Open Collective crowdfunding project. From the project page:

As the Tidal community grows, this opencollective fund will accept donations towards development and documentation initiatives for the project, and potentially artist development opportunities. The overall aims will be:

  • To develop free/open source software that reimagines computer programming as a live interface for musicians and other artists to creatively explore patterns.
  • To make the software more accessible, including through documentation, translation and design, and encourage contributions from more people
  • To foster a community of contributors and other users from diverse backgrounds.


Tidal Cycles and SuperDirt have been developed with contributions from a wide range of people - Tidal contributors / SuperDirt contributors.

Tidal Cycles was initiated by Alex McLean around 2009 during doctoral work funded by EPSRC. Alex' ongoing work on Tidal has been supported in part by various ad-hoc contributors, and grants (eg the PENELOPE project, under the Horizon 2020 research and innovation programme of the European Union, grant agreement No 682711).

In 2021, Alex moved the project's public financial contribution support model from an individual/personal contribution type (via Ko-fi), to a an Organisational Model via the OpenCollective platform, at the same time appointing an experienced admin team to handle the ongoing project accounting in a transparent and ethical manner.

TidalCycles has been heavily inspired by the work of many others including Bernard Bel, Laurie Spiegel and Adrian Ward.