● Notebooks / Lua scripting / six progressive pieces
Notebooks
Brume ships with six tutorial scripts. Each makes sound immediately on load and teaches one concept through commented, modifiable code. Start with Notebook 1, change a number, save the file, hear it via hot-reload.
Notebook 01
Sound
note_on
Notebook 02
Rhythm
clock.sync
Notebook 03
Chords
brume.chord
Notebook 04
Control
add_param
Notebook 05
Layers
coroutines
Notebook 06
Effects
set_fx
Notebook 01 · Sound
One line makes sound.
The simplest script in Brume. A single call to brume.note_on is enough to play a note. Load this script on the SCRIPT page and a steady A3 plays through the Timbral engine.
Change the number to try a different note. Save — Brume hot-reloads within two seconds and you hear the change.
◆ Reference
A small, expressive surface.
Notes
brume.note_on(part, note, vel)
Trigger a MIDI note on a part. Velocity is 0.0 – 1.0.
Notes
brume.note_off(part, note)
Release a MIDI note on a part.
Parameters
brume.set_param(part, name, val)
Set any of the 52 synthesis parameters. Names match the UI.
Music
brume.chord(root, type)
Returns a table of MIDI notes. maj, min, maj7, dom7, sus4, 9, …
Music
brume.scale(root, intervals)
Build a scale from a root and interval table.
Transport
brume.schedule(beat, fn)
Call a function at an absolute beat position.
Clock
clock.run(fn)
Launch a coroutine on the transport clock.
Clock
clock.sync(beats)
Yield for a musical duration. 1/4 = quarter note.
DSP
dsp.delay(max)
Delay line with linear interpolation. :process, :set_time.
DSP
dsp.allpass(max, gain)
Schroeder allpass for reverb diffusion.
DSP
dsp.lowpass(cutoff)
One-pole lowpass filter. :process, :set_cutoff.
Screen
screen.fill_circle(x, y, r)
Custom 20fps visualizer surface for Lua FX panel.