Describe your TouchOSC
controller in a simple text format and download a ready-to-import .tosc file in seconds.
The generated layouts are designed as starting points — import one, then
adjust sizes, colours and positions in the TouchOSC editor to match your exact workflow.
Page N
Panel Name COLS,ROWS [PAGE_COL,PAGE_ROW]
Control Name SIZE,COL,ROW[,flags]| Token | Meaning |
|---|---|
COLS,ROWS | Panel's internal grid — columns × rows. Width on page is proportional to COLS. |
PAGE_COL,PAGE_ROW | Explicit page placement. Same PAGE_ROW → panels share one horizontal band. PAGE_COL (letter a b c…) orders them left-to-right. Omit for auto side-by-side grouping of same-type panels. |
SIZE | 1 – 3. Row height weight: size 3 rows are tallest. Also scales knob size within its cell. |
COL | Column letter: a = col 1, b = col 2, … |
ROW | Row number: 1, 2, 3, … |
bp | Flag — bipolar: knob sweeps ±, default 0.5, double-tap resets to centre. |
f | Flag — fader (vertical slider instead of knob). |
Lines starting with # are comments. Indentation: 4 spaces for panels, 8 for controls. Reference: 10 size-3 knobs span the full iPad width.
MIDI CCs are assigned automatically starting at CC 25, incrementing per control. When CC 127 is reached the channel advances (ch 1 → ch 2 …) and assignment restarts at CC 25. Standard performance CCs are skipped automatically: 64 sustain, 65 portamento, 66 sostenuto, 67 soft pedal, 68 legato.
Page 1
# Three OSC panels side by side (explicit positions a,1 b,1 c,1).
# Each is 2 cols × 5 rows — total COLS 6, so each gets 33 % of the page.
OSC 1 2,5 a,1
Tune 3,a,1,bp
Modify 2,b,1,bp
Phase 3,a,2
Phase Mod 2,b,2,bp
Shape 3,a,3
Shape Mod 2,b,3,bp
Fract 3,a,4
Fract Mod 2,b,4,bp
Volume 3,a,5
Modulation 2,b,5
OSC 2 2,5 b,1
Tune 3,a,1,bp
<same controls…>
# LFO (2×2) + two Envs with faders, in page row 2.
# Width ratio 2 : 4 : 4 → 20 % / 40 % / 40 %.
LFO 1 2,2 a,2
Rate 2,a,1
Wave 2,b,1
Env 1 4,2 b,2
Attack 2,a,1,f
Decay 2,b,1,f
Sustain 2,c,1,f
Release 2,d,1,f
Page 2
Filter 1 4,3
Cutoff 3,a,1,bp
Resonance 3,b,1
Env Amt 2,c,1,bp
Drive 2,d,1