TouchOSC Layout Generator

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.

Target device size — TouchOSC scales layouts to fit the screen, so the canvas size mainly sets the aspect ratio and overall density. Use the dropdown below, or override it inline at the top of your spec with Size W×H (e.g. Size 1366x1024). Common device sizes (landscape, logical points):

Device	Canvas (landscape)
iPad mini 5th gen (7.9")	`1024 × 768`
iPad mini 6th / 7th gen (8.3")	`1133 × 744`
iPad 9th gen (10.2")	`1080 × 810`
iPad 10th / 11th gen, Air 11" M2+ (10.9"–11")	`1180 × 820`
iPad Pro 11" 1st / 2nd gen	`1194 × 834`
iPad Pro 11" 3rd gen (M1) and newer	`1210 × 834`
iPad Pro 12.9" all gens, Air 13" M2+	`1366 × 1024`
iPad Pro 13" M4 and newer	`1376 × 1032`
iPhone SE 2020 / 2022	`667 × 375`
iPhone 12 / 13 mini	`812 × 375`
iPhone 12 / 13 / 14 (6.1")	`844 × 390`
iPhone 15 / 16 (6.1")	`852 × 393`
iPhone 14+ / 15+ / 16+ / Pro Max	`932 × 430`
iPhone 15 / 16 / 17 Pro Max	`956 × 440`

Show full example

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