Live-code music in your terminal.

rustel is a native engine for the Strudel pattern language. Use the full-fledged embedded Studio for music production and live performance. Or live-code in Neovim, or in your favorite text editor. VST3 plugins, MIDI, Ableton Link, low-latency audio in, OSC for SuperDirt, serial, webcam, and gamepad are built in. One binary. No browser. No server.

Already on strudel.cc? Bring your patterns here. Almost everything from Strudel works. The compatibility docs describe native support limits and missing or inactive features.

# Install

curl -fL https://rustel.cc/install | bash

Apple Silicon and Intel. Open a new terminal, then run rustelup to install the engine. Then run rustel studio.

curl -fL https://rustel.cc/install | bash

x86_64 and ARM64, including WSL 2. Requires glibc 2.39 or later, ALSA, and libudev. Open a new terminal, then run rustelup to install the engine. Then run rustel studio.

irm https://rustel.cc/install.ps1 | iex

Windows 10 or later, x86_64, in PowerShell 5 or later. Open a new terminal, then run rustelup to install the engine. Then run rustel studio.

rustelup installs into ~/.rustel/bin. On Windows that folder is %USERPROFILE%\.rustel\bin. Run the updater again to refresh, or add --version v<version number here> to pin a build. For dependencies and troubleshooting, see the installation guide. To build from source, follow the build guide.

# What you get

# The studio

Press Ctrl+Enter to update. Same chord as strudel.cc. The piano roll and the scope follow the pattern.
Ctrl+Enter
Update and play. Strudel's update chord. A bad update leaves the last good score playing. Ctrl+. stops.
keyboard
Everything is reachable from the keyboard. The mouse works too. Keyboard-only is the easier grip in a live set.
beat
The sounding step lights in your source. The header dot pulses on the downbeat.
Ctrl+D
Open the reference. Every function in the language, inside the editor.
visuals
Piano roll, punchcard, scope, and spectrum as rows in the editor, plus a mixer and a minimap.
editor
Modeless. Selection, undo, redo, bracketed paste. Saves stay off the audio thread.

# The command line

Run the engine from a shell. Watch a file. Bounce a render. Query a cycle. Open Studio.

# play and reload on each stable save
$ rustel song.strudel --watch

# bounce a render
$ rustel render song.strudel -o take.wav --format scalar-wav --duration 60

# check a score without sound
$ rustel check song.strudel

# replay a jam from its session tape
$ rustel replay tonight.rustel-session

# list audio and MIDI devices
$ rustel devices

# print one cycle as JSON
$ rustel query -e 'note("c e g").s("piano")' --json

# install shell completion
$ rustel completions --install

# open Studio on your last set (creates one on first use)
$ rustel studio

# open a score file (starter score if the path is new)
$ rustel studio song.strudel

# open a set folder
$ rustel studio set/

# Neovim

The rustel-neovim plugin plays the buffer you have open. Syntax colors the score. Active notes light up as they sound. Scope, piano roll, spectrum, and spiral draw in the buffer.

Neovim 0.9 or newer, and rustel on your PATH. Ctrl+Enter updates. Ctrl+. stops.

# Under the hood

Rust schedules patterns and runs DSP. Sandboxed QuickJS evaluates Strudel JavaScript. Ratatui draws Studio. DSP kernels pick SIMD paths from your CPU for low CPU and memory use. rustel doctor and Studio's About panel show the active kernels.

# Terminal setup and known limits

The Studio guide covers terminal profiles, keyboard fallbacks, and graphics modes.

# Support Rustel

If Rustel is part of your music-making, consider a donation to support its development. Any amount is appreciated.

Ethereum & EVM chains

0x6900e16f4322130c54Ced2D80c12D396aA6d190f
View on Etherscan