Documentation

This page mirrors the control help shown inside the app (toggle with H).

Keybindings #

Control	Action
H	toggle help
N	create new loop
CLICK INSIDE O	select loop (nearest center)
DRAG O	move selected loop (pan/volume)
CLICK PERIMETER O	jump cut on selected loop
DBL-CLICK OUTSIDE O	clear loop selection
CLICK+DRAG OUTSIDE O	adjust selected parameter
LEFT / RIGHT	select parameter
UP / DOWN	adjust value (or LFO period)
P	global play/stop all loops
SPACE / P	toggle selected loop playback
R	toggle selected loop recording
Z	tap: load preset, hold 1s: save slot
I / O	hold 1s: load / save session archive (.zip)
C / V	copy selected loop / paste duplicate
DELETE / BACKSPACE	hold 1s: delete selected loop
X	hold 1s: clear selected loop audio
F1..F12	select loop 1..12
0..7	cut: 0/8..7/8 (selected/all)
T	toggle dark/light theme
L	toggle LFO on selected parameter
Q / A	increase / decrease LFO min (x)
W / S	increase / decrease LFO max (y)

Tape Controls #

The tape controls provide another way to control the loops when hotkeys are not an option.

Press Play () to play a loop (when selected) or all loops (when not). Press Stop () to stop all loops, or the selected loop if it is the only one playing. When stopped, press Stop () again or key 0 to jump to the start of the loop(s).

Press Forward () or Reverse () to step the playback rate up or down, respectively. Press Play () twice to return to normal speed.

Press Record () to toggle recording on the selected loop. Note, in Continuous Mode, if you stop a recording that was started from the beginning it will size the loop to the length of the recording.

Loop Parameters #

Loop parameters are accessible by clicking a loop. Use ← / → to scroll through parameters and ↑ / ↓ to change values.

Values can also be adjusted at any time by clicking a non-loop area of the screen and dragging the mouse up and down.

Additionally, values can be set to change via an LFO by pressing L and then using hotkeys: Q/A increases/decreases LFO min (x) and W/S increases/decreases LFO max (y).

Mix #

Volume sets loop output level and Pan places the loop in the stereo field.

Window #

Loop Start and Loop Length define the active playback window within the loop allocation.

Playback #

Rate changes playback speed/pitch, Fade Time controls loop boundary crossfade and also sets post-roll duration when using Record Mode = Once, and DAW Sync links loop timing behavior to host transport sync state.

Record Path #

Record New controls incoming write level, Record Keep controls retained buffer level during overdub, Record Mode selects Continuous (default) or Once, and Reverb sets loop send amount to the reverb bus.

In Record Mode = Once, recording automatically disarms after one loop span and applies post-roll equal to the current Fade Time.

Tape #

Tape Bias and Tape Gain shape tape drive behavior; Bass Freq, Bass Boost, and Bass Q tune the low-frequency tape contour.

Filters #

Post LPF/Post LPF Q and Post HPF/Post HPF Q control post-stage low-pass and high-pass filter cutoff and resonance.

Note Envelope #

Note Attack, Note Decay, Note Sustain, and Note Release define the per-note ADSR envelope for note-triggered loop playback.

Note Trigger/MIDI #

Note Start % randomizes note start offset, MIDI CH sets MIDI channel filtering per loop, and Note Mode chooses the note playback start behavior.

Global Parameters #

Global parameters are reached by double-clicking anywhere that is not a loop to open the global parameters menu. Navigate with ← / →, change values with ↑ / ↓, or click-drag in a non-loop area to adjust values directly.

Length/Tempo #

Length Mode controls loop length quantization behavior, and Length BPM sets the tempo used for beat-based length calculations.

Record Chain #

Record Chain is great for recording a series of loops in order. When enabled, starting recording on one loop can hand off recording to the next loop when the current loop reaches its boundary, continuing through the remaining loop order.

To use it, select the loop you want to start from and toggle recording with R (or the loop record gesture). Turning Record Chain off cancels future automatic handoffs; manually stopping the currently chained loop also stops the rest of the chain.

Mix: Input, Dry, Wet #

Input sets global input trim, while Dry and Wet control global dry/wet output balance.

Reverb #

These parameters shape the global reverb path: Predelay, input level, LPF, HPF, damping, mod frequency and mod depth.

MIDI #

Using oooo with a MIDI keyboard lets you play the loops as if it were a Mellotron - each note will change the rate scaling of the playing loop based around middle C. MIDI note input is handled per loop through MIDI CH and Note Mode: channel mode decides which incoming channels are accepted, note mode decides where playback starts on note-on, and note-off (including note-on with velocity 0) releases active note heads while Note Attack, Note Decay, Note Sustain, Note Release, and Note Start % shape the loop’s note response.

Grid #

A monome grid is automatically detected in oooo. When a monome grid is detected, an icon () appears automatically in the top-right corner. Each 8x8 section of the grid (a "tile") controls one loop. Column 1 is the tile menu and columns 2-8 are the active area.

Each tile has four modes: Isomorphic (col1,row1), Slice (col1,row2), Volume/Pan (col1,row3), and Rate (col1,row4). In Slice mode, playhead and loop span are shown across columns 2-8 in recorded-normalized space.

Grid Tutorials

Use these guided tours for layout, mode rows, mode-specific gestures, and gesture recording.

Isomorphic Tile Reference (8x8)

Column 1 is the tile menu. Columns 2-8 show note names sent in Isomorphic mode (note + octave). C notes are dimly highlighted. Example below: held D4 is bright, matching D4 pads are ghost-highlighted.

Anchor used by current runtime mapping: local tile row=8, col=2 is C2 (MIDI 36).

Live Coding #

Open Live Coding by clicking the terminal icon () in the top-right app bar. This opens the browser-based Lua editor at http://127.0.0.1:17321/ by default.

Run the whole file or selected lines to create loops, shape playback, and control engine globals from Lua.

Common commands include o.create, o.set(loop_id, ...), o.get(), o.record, and o.play.

Example 1: Create, Record, and Play

-- create and start a 4 second loop
loop_id, err = o.create({ seconds = 4.0, fade = 0.15 })
assert(loop_id, err)
o.record(loop_id, true)
o.play(loop_id, true)

Example 2: Update, Query, and Jump

o.set(loop_id, {
  pan = -0.25,
  db = -6.0,
  pan_slew = 0.3,
  db_slew = 0.3,
})

state = o.get(loop_id)
print('seconds', state.seconds, 'playing', state.playing)
o.jumpn(loop_id, 0.5)

Example 3: Set and Read Engine Globals

o.set({
  in_db = -3,
  wet_db = -6,
  rv_predelay = 12,
  rv_mod_depth = 2,
})

engine = o.get()
print('input', engine.in_db, 'wet', engine.wet_db)

o.* API Reference

This reference reflects the current runtime Lua bindings. Mutating commands return true on success, or nil, err on failure.

Setters / Mutators #

Functions are listed first. Any opts/props object keys are defined in the props tables directly below.

Function	Parameters	Returns	Notes
`o.create(opts)`	`opts` table (optional)	`loop_id` \| `nil, err`	`opts` keys come from Loop Props.
`o.set(loop_id, props)`	`loop_id` integer, `props` table	`true` \| `nil, err`	`props` keys come from Loop Props.
`o.set(props)`	`props` table	`true` \| `nil, err`	`props` keys come from Engine Props.
`o.record(loop_id, on)`	`loop_id` integer, `on` boolean	`true` \| `nil, err`	Starts/stops recording on one loop.
`o.play(loop_id, on)`	`loop_id` integer, `on` boolean	`true` \| `nil, err`	Starts/stops playback on one loop.
`o.jump(loop_id, seconds)`	`loop_id` integer, `seconds` number	`true` \| `nil, err`	Seeks to timeline seconds.
`o.jumpn(loop_id, normalized)`	`loop_id` integer, `normalized` number	`true` \| `nil, err`	`normalized` must be in `[0, 1]`.
`o.bpm(value)`	`value` number	`bpm` \| `nil, err`	`value` must be `> 0`.
`o.clear(loop_id)`	`loop_id` integer	`true` \| `nil, err`	Clears loop audio/buffer content.
`o.delete(loop_id)`	`loop_id` integer	`true` \| `nil, err`	Deletes a loop.

For o.create(opts), length resolution order is: beats (if > 0), then seconds (if > 0), else defaults to 10.0 seconds.

Loop Props (for `o.create(opts)` and `o.set(loop_id, props)`)

Key (opts/props)	Meaning	Range / Behavior
beats	Loop length in beats.	Number; must be `> 0` to apply. Converted using current `o.bpm()`.
seconds	Loop length in seconds.	Number; must be `> 0` to apply.
fade	Post-roll / fade time.	Clamped to `[0, 20]` seconds.
pre	Buffer keep amount.	Clamped to `[0, 1]`.
pre_slew	Slew time for `pre`.	Seconds; negative values are treated as `0`.
rec	Input write gain.	Clamped to `[0, 1]`.
rec_slew	Slew time for `rec`.	Seconds; negative values are treated as `0`.
db	Loop output level in dB.	Upper-clamped by engine to about `+12 dB`.
db_slew	Slew time for `db`.	Seconds; negative values are treated as `0`.
pan	Stereo pan position.	Clamped to `[-1, 1]`.
pan_slew	Slew time for `pan`.	Seconds; negative values are treated as `0`.

Engine Props (for `o.set(props)`)

Parameter	Meaning	Range / Behavior
in_db	Global input trim (dB).	Upper-clamped to `+24 dB`; supports very low values including `-inf`.
dry_db	Global dry level (dB).	Upper-clamped to `+24 dB`; supports very low values including `-inf`.
wet_db	Global wet level (dB).	Upper-clamped to `+24 dB`; supports very low values including `-inf`.
in_db_slew	Slew time for `in_db`.	Seconds; must be `>= 0`, negative values return error.
dry_db_slew	Slew time for `dry_db`.	Seconds; must be `>= 0`, negative values return error.
wet_db_slew	Slew time for `wet_db`.	Seconds; must be `>= 0`, negative values return error.
rv_predelay	Reverb predelay (ms).	Clamped to `[0, 300]` ms.
rv_predelay_slew	Slew time for `rv_predelay`.	Seconds; must be `>= 0`, negative values return error.
rv_in	Reverb input amount (%).	Clamped to `[0, 100]` %.
rv_in_slew	Slew time for `rv_in`.	Seconds; must be `>= 0`, negative values return error.
rv_lpf	Reverb input low-pass cutoff (Hz).	Clamped to `[1, 20000]` Hz.
rv_lpf_slew	Slew time for `rv_lpf`.	Seconds; must be `>= 0`, negative values return error.
rv_hpf	Reverb input high-pass cutoff (Hz).	Clamped to `[1, 1000]` Hz.
rv_hpf_slew	Slew time for `rv_hpf`.	Seconds; must be `>= 0`, negative values return error.
rv_damp	Reverb damping frequency (Hz).	Clamped to `[10, 20000]` Hz.
rv_damp_slew	Slew time for `rv_damp`.	Seconds; must be `>= 0`, negative values return error.
rv_mod_freq	Reverb modulator frequency (Hz).	Clamped to `[0.01, 4.0]` Hz.
rv_mod_freq_slew	Slew time for `rv_mod_freq`.	Seconds; must be `>= 0`, negative values return error.
rv_mod_depth	Reverb modulator depth (ms).	Clamped to `[0, 10]` ms.
rv_mod_depth_slew	Slew time for `rv_mod_depth`.	Seconds; must be `>= 0`, negative values return error.

Getters / Queries #

Function	Parameters	Returns	Notes
`o.get(loop_id)`	`loop_id` integer	`loop_state` \| `nil, err`	Returns one loop snapshot table.
`o.get()`	none	`engine_state` \| `nil, err`	Returns global engine snapshot table.
`o.list()`	none	`{loop_id, ...}` \| `nil, err`	Returns sorted loop IDs.
`o.bpm()`	none	`number` \| `nil, err`	Returns current BPM.

`o.get`

Form: o.get(loop_id) returns loop_state or nil, err.

Field	Meaning	Range / Type
loop_id	Loop identifier.	Integer.
playing	Current playback state.	Boolean.
recording	Current recording state.	Boolean.
pos	Current position (seconds).	Number.
pos_norm	Current normalized position.	Number in `[0, 1]`.
seconds	Current loop length.	Number, expected `> 0`.
alloc_seconds	Allocated loop buffer length.	Number, expected `> 0`.
fade	Post-roll / fade time.	Number in `[0, 20]`.
pre	Buffer keep amount.	Number in `[0, 1]`.
pre_slew	Slew time for `pre`.	Number, `>= 0`.
rec	Input write gain.	Number in `[0, 1]`.
rec_slew	Slew time for `rec`.	Number, `>= 0`.
db	Loop output dB target.	Number, upper-clamped by engine.
db_slew	Slew time for `db`.	Number, `>= 0`.
pan	Stereo pan target.	Number in `[-1, 1]`.
pan_slew	Slew time for `pan`.	Number, `>= 0`.

`o.get`

Form: o.get() returns engine_state or nil, err.

Engine Field	Meaning	Range / Type
in_db / dry_db / wet_db	Global mix dB values.	Number, upper-clamped to `+24 dB`.
in_db_slew / dry_db_slew / wet_db_slew	Lag time for global dB values.	Number, `>= 0`.
rv_predelay	Reverb predelay.	Number in `[0, 300]` ms.
rv_predelay_slew	Predelay lag time.	Number, `>= 0`.
rv_in	Reverb input amount.	Number in `[0, 100]` %.
rv_in_slew	Reverb input amount lag.	Number, `>= 0`.
rv_lpf / rv_hpf / rv_damp	Reverb filter/damping frequencies.	`rv_lpf`: `[1, 20000]` Hz, `rv_hpf`: `[1, 1000]` Hz, `rv_damp`: `[10, 20000]` Hz.
rv_lpf_slew / rv_hpf_slew / rv_damp_slew	Lag time for reverb filter/damping params.	Number, `>= 0`.
rv_mod_freq / rv_mod_depth	Reverb modulation params.	`rv_mod_freq`: `[0.01, 4.0]` Hz, `rv_mod_depth`: `[0, 10]` ms.
rv_mod_freq_slew / rv_mod_depth_slew	Lag time for reverb modulation params.	Number, `>= 0`.
bpm	Current BPM.	Number, `> 0`.

Need setup/download info? Visit Downloads or Buy.

Documentation

Keybindings #

Tape Controls #

Loop Parameters #

Mix #

Window #

Playback #

Record Path #

Tape #

Filters #

Note Envelope #

Note Trigger/MIDI #

Global Parameters #

Length/Tempo #

Record Chain #

Mix: Input, Dry, Wet #

Reverb #

MIDI #

Grid #

Grid Tutorials

Isomorphic Tile Reference (8x8)

Live Coding #

Example 1: Create, Record, and Play

Example 2: Update, Query, and Jump

Example 3: Set and Read Engine Globals

o.* API Reference

Setters / Mutators #

Loop Props (for o.create(opts) and o.set(loop_id, props))

Engine Props (for o.set(props))

Getters / Queries #

o.get

o.get

Loop Props (for `o.create(opts)` and `o.set(loop_id, props)`)

Engine Props (for `o.set(props)`)

`o.get`

`o.get`