Skip to main content


Tidal-vis is a tool made by Alex McLean to visualize Tidal patterns. This package allows several things:

  • OSC messages sent to SuperCollider to be dynamicly rendered in realtime with a separate window. Demo of realtime visualisation.
  • Colour patterns to be rendered as PDF or SVG files. See Examples.hs in the GitHub repository for more help.
  • Colour patterns to be rendered to be rendered dynamicly in separate window. See CycleAnimation.hs for more. Demo.

Setup tidal-vis#

  1. Comment out any existing lines in BootTidal.hs that begin with tidal <- startTidal.

  2. Add the following lines to BootTidal.hs:

-- Target and shape for pattern visualizing.
patternTarget = Target { oName = "Pattern handler", oAddress = "", oPort = 5050, oBusPort = Nothing, oLatency = 0.02, oWindow = Nothing, oSchedule = Pre BundleStamp, oHandshake = False }
patternShape = OSC "/trigger/something" $ Named {requiredArgs = []}
-- Target for playing music via SuperCollider.
musicTarget = superdirtTarget { oLatency = 0.1, oAddress = "", oPort = 57120 }
config = defaultConfig {cFrameTimespan = 1/20}
-- Send pattern as OSC both to SuperCollider and to tidal-vis.
tidal <- startStream config [(musicTarget, [superdirtShape]), (patternTarget, [patternShape])]
-- Send pattern as OSC to SuperCollider only.
-- tidal <- startTidal musicTarget config
  1. Install tidal-vis and run:
cabal update
cabal install tidal-vis
  1. Eval your Tidal code.

Learn more#

To learn more about tidal-vis, head to the GitHub repository of the project.

Last updated on by Ian Clester