Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

pattrns

is an experimental imperative music sequence generator engine that lets you create musical patterns programmatically using Lua scripts for algorithmic or live music coding.

This guide focuses on the Lua scripting API. For Rust development, see the pattrns crate docs.

Key Features

Programmatic
Build musical patterns using dynamic scripts or precompiled code.
Modular
Combine and reuse patterns components dynamically.
Generative
Make evolving compositions that change over time.
Dynamic
Modify patterns live, during playback.
External Control
Connect with MIDI/OSC controllers for hands-on parameter tweaking.
Templates
Create user configurable pattern templates.
Cycles Mini-Notation
Use familiar Tidal Cycles mini-notation for rapid pattern creation.

Applications

Online Playground
Experiment with pattrns scripts directly in your browser.
Renoise
Use patterns in its instrument phrase editor.
Rust Examples
Write or test scripts in Rust or Lua with a basic sample player.