Piratidal

Experimental Clojure port of TidalCycles. This is a very early work in progress and so far more of a proof of concept.

Table of Contents

Piratidal

Installation

Piratidal requires the installation of Java, the clojure-cli and a suitable editor (one with a Clojure repl). You will also need to download SuperCollider and install SuperDirt.

Java - If you don't already have Java installed I recommend open-jdk.
clojure-cli - https://clojure.org/guides/install_clojure
Editor - If you are new to Clojure a good place to start might be the Calva VSCode plugin. However you can find many other options in the following link https://clojure.org/guides/editors or https://practical.li/clojure/clojure-editors/#clojure-aware-editors. If you just want to try Piratidal without an editor repl, you can simply start a repl with the clojure-cli.
- If using the clojure-cli, navigate to the piratidal directory in a terminal, and call the clojure or the clj command.
SuperCollider - SuperCollider can be downloaded from here: https://supercollider.github.io/downloads. SuperDirt can be installed by following these instructions: Linux, MacOs, Windows

Usage

Open SuperCollider and evaulate the following line of code:

SuperDirt.start

The start a Clojure repl by following the instructions of the plugin from your editor of choice or running the following line of code in your terminal (while inside the piratidal directory).

$ clj

Then in an editor file or your terminal repl evaluate the following:

(require '[piratidal.core :refer :all])

(p 1 (-> (s "[bd cp/2 hh]")
         (jux rev)))

You can also use the examples file at dev/examples.cljc to try other stuff out.

The API that has been already implemented can be found in the piratidal.core namespace in the def-main-and-control-patterns, def-pattern-transformations and import-vars forms. If using the -> (thread) macro, the API replicates very closely Tidal's own.

(un)Implemented Features

Parser

Most of the parser's functionality is already implemented. Notable missing things are the following:

Elongation probably doesn't work 100%.
Patterned operations such as bd*<1 2>. Operations missing this are fast, slow, euclidean rhythms, elongation, replication and degradation.
The fastcat operator ..
Variables
Chords

diegovdc/piratidal

Piratidal

Installation

Usage

(un)Implemented Features

Parser

Tidal's API Implemented So Far