SOMA23 GRIDAndroid app · version 2.2

SOMA23GRID

A clip launcher and a mixer for Ableton Live, on your tablet. The 64-pad grid, 9 faders, track and device knobs, a crossfader and the full transport, connected to the computer as native USB MIDI. And for playing: MPC-style note repeat, and parameter banks you put together yourself.

Android 6 or later · tablet in landscape · USB data cable · Ableton Live 10.1.13 or later · interface in French

SOMA23 GRID 2.2, PADS page: the grid in SESSION mode with the clips of a demo set, the tracks above it and the scenes on the right; in the right-hand column, SESSION, DRUM, NOTE, the PADS and FADERS buttons, NOTE REPEAT and its rates, the note repeat strip, FULL LEVEL, 16 LEVELS, SWING, ERASE, MUTE PAD, SOLO PAD, record quantization, QUANTIZE, CAPTURE, UNDO and REDO

PADS page, rendered at the Xiaomi Pad 5 resolution, with a demo set

What 2.2 changes

The ergonomics, without removing a single function: the pads and the faders are on two full-screen pages, PADS and FADERS. The PADS and FADERS buttons, at the top right, are always in the same place: one tap to switch from one to the other.

The PADS page

The grid, wider, and everything you play with: the track and scene buttons, SHIFT, the arrows, the overview, the SESSION, DRUM and NOTE modes, and the MPC-style tools (note repeat, touch strip, swing, FULL LEVEL, 16 LEVELS, ERASE…).

On the Xiaomi Pad 5, a pad goes from 93 × 93 to 115 × 93, in units of the app’s 1600 × 1000 virtual screen; on the Galaxy S23, to 150 × 93.

The FADERS page

The MIX, DEVICE and MODES tabs across the full width, with the 9 faders full size: a strip 170 wide instead of 66 (same units), big fader caps, and your finger can land anywhere in the strip, not just on the cap.

Switching pages releases whatever is held (pad, fader, SHIFT): no stuck notes. Everything else stays as it is, and the page on display is kept for next time.

SOMA23 GRID 2.2, FADERS page, MIX tab: send A knobs for each track and CUE, A|B, activator, solo and arm buttons, track names, 9 large faders and the crossfader at the bottom

FADERS page, MIX tab, at the Xiaomi Pad 5 resolution

The 2.1 layout, all on one screen, is still available: Réglages › Interface (settings › interface) › “Pads et faders sur le même écran” (pads and faders on the same screen). On first launch after the update, a message introduces the two pages; its “Disposition 2.1” button keeps the old layout. The Ableton script doesn’t change: 2.2 uses the 2.1 one, and the protocol stays the same.

What 2.1 had added

The PADS page, MPC-style

Note repeat from 1/4 to 1/32, triplets included, with swing and a touch strip for rolls; FULL LEVEL, 16 LEVELS, ERASE, pad mute and solo, record quantization, QUANTIZE, CAPTURE, UNDO and REDO.

Note repeat, FULL LEVEL and 16 LEVELS run in the app: they work even without the script, with any software.

Custom banks

In the manner of PrEditor 2: up to 64 banks of 8 per type of device, with any parameter of the device, including those Live puts in no bank, the track’s volume, pan or a send, a macro of the rack that contains it, empty slots and your own names.

The editor is on the tablet, with no Max for Live device to add: copy, paste, move, export and import.

Since 2.0

Version 1.0 took up the idea of 8 × 8 grid controllers with 9 faders. Version 2.0 added what an APC40 mk2-style controller brings; the 1.0 mode rows live on the MODES tab of the FADERS page.

Track knobs: 8 endless knobs, for panning, sends or USER for MIDI Learn, plus a 9th for the headphone level (CUE).

DEVICE tab: the 8 parameters of the selected device, with their names and the values Live displays; neighbouring device, bank, ON / OFF.

Per-track buttons: crossfader side (A|B), mute, solo, arm, and selecting the track or the master.

Crossfader: Live’s own, at the bottom of the MIX tab; double-tap to return to centre.

Full transport: arrangement and session recording, NUDGE − / +, tempo set by sliding on the BPM, resume playback.

Global quantization: SHIFT + track names, from “none” to 1/16.

Overview: the grid shows the whole set in blocks of 8 tracks × 8 scenes, to jump there with one tap.

LOCK: the knobs stay on a device, even when you change track.

The grid, Live, and nothing in between

Like SOMA23 KEYS, the app uses Android’s “MIDI” USB mode, and a script installed in Live makes the link. It takes up the layout of grid-and-knob controllers, and the screen adds what buttons alone can’t show.

What the screen adds

The colour and name of every clip, track, scene, parameter and Drum Rack pad; the animated state of clips (playing in time, triggered, recording); values as Live displays them; the device being controlled and its bank; the transport, the tempo and the position.

A script for Live

The script reads the state of the set every 100 ms and only sends what changes. The grid follows the selection: pick a track or a scene outside the frame in Live, and the frame moves. Clip launch modes and Live’s Select on Launch option are respected.

It also tells Live when each gesture on a fader, a knob or the crossfader begins and ends, a signal Live provides to group the undo and the automation recording of a single gesture.

Alongside SOMA23 KEYS

Both scripts can stay loaded in Live, on the same port: they don’t listen to the same messages, and versions 2.0 and 2.1 only add new ones among the free numbers. You switch from one app to the other without touching the preferences.

The surface

Two full-screen pages, PADS and FADERS; at the top of both: the connection, the position, the tempo and the transport. PADS page: the grid, with the track buttons above it and the scene buttons on the right, then the pad modes and the playing tools. FADERS page: the MIX, DEVICE and MODES tabs. The secondary functions, with SHIFT held, are written in orange below and on the buttons. The labels are those shown in the app.

PADS page: the grid

8 × 8 GRID
In SESSION mode, a pad is a clip slot, with the clip’s colour and name. A press launches the clip, respecting its launch mode (Trigger, Gate, Toggle, Repeat); on an empty slot, it stops the track, or records if the track is armed · selects the slot without launching it.
PAD STATES
▶ and an outline pulsing in time: playing. Flashing: triggered. Red with ●: recording. Red ○: empty slot on an armed track. Double line: group track slot. White outline: slot selected in Live.
SCENES
The right-hand column launches the scenes, with their name and colour from Live. They flash when triggered; white outline for the selected scene. STOP ALL, below them, stops every clip.
TRACKS
The top row: each track’s name and colour, and an action according to the mode chosen on the MODES page. STOP CLIP by default (■ lit if a clip is playing, flashing when the stop is triggered), SOLO, MUTE, ARM (dimly lit: armed automatically), SELECT.
▲ ▼ ◀ ▶
In SESSION, move the grid by one track or one scene · by 8; held: scrolling. In DRUM, ▲ ▼ move 16 pads up or down. In NOTE, ▲ ▼ change the octave.
BANK × 8
When on, the arrows move the grid by 8 tracks or 8 scenes.
VUE ENSEMBLE
The overview of the set, further down.
OCT − / + · SCALE
In NOTE mode: the octave, from −3 to +3, then the root, the scale and the layout.

The transport, at the top of both pages

− NUDGE · + NUDGE
Held, they slow Live down or speed it up for as long as your finger stays down, to line up by ear.
BPM
Slide up or down: ±0.1 BPM per step · 0.01.
PLAY · STOP
Play and stop · resume where playback stopped. STOP when stopped: back to the start.
● ARRANG. · ● SESSION
Arrangement recording, session recording.
METRO · TAP
Metronome, tap tempo. The bar also shows the USB and Live connection, the position, and the grid’s position when the screen is wide enough; ⚙ opens the settings, ? the help.
PADS · FADERS
Just below, on the right: switch from one page to the other. The pad mode, the MIX, DEVICE or MODES tab, note repeat and its rate stay as they are.

FADERS page, MIX tab

One strip per track, as on the APC40 mk2. The 9 faders (8 + master) are on all three tabs: they never jump when touched, the value moves on from where it is, and your finger can land anywhere in the strip; double-tap: default value · fine adjustment.

PAN · SENDS · USER
The mode of the 8 track knobs. PAN: panning. SENDS: send A; pressed a second time, next send; held with track name n, send n. USER: CCs 111 to 118 on the playing channel (absolute values), for MIDI Learn.
8 KNOBS
Endless, the ring follows Live’s value. Sliding up increases; touching shows the value; double-tap: default value · fine adjustment.
CUE
The 9th knob: Live’s headphone (preview) level.
A|B
The track’s crossfader side: none → A → B → none (A in orange, B in blue).
1 TO 8
The activators: number lit, track active; a press mutes or unmutes the track, as on the original.
S · ●
Solo; arm (dimly lit: armed automatically).
TRACK NAMES
Select the track; MASTER selects the master · global quantization.
FADERS
Volume, or the mode chosen on the MODES tab, recalled in orange above them.
CROSSFADER
Live’s own; double-tap: back to centre.

DEVICE tab

The device being controlled is the one with the blue hand: the selected device or, on a Drum Rack without mapped macros, as in Live, the first device of the selected pad. The faders stay, shorter; in DEVICE mode, they control the same device and the same bank.

◀ DEVICE ▶
The neighbouring device on the selected track, lit if there is one in that direction; the device chain shows in Live.
◀ BANK ▶
The parameter bank: Live’s native banks for its own devices, macros for racks, parameters in order for plug-ins; your custom banks if there are any (PERSO label).
8 KNOBS
The bank’s 8 parameters, with their names and the values Live displays.
ON / OFF
Turns the device on or off.
LOCK
Locks the knobs to this device, even when you change track (orange “VERROUILLÉ” frame, meaning locked).
CLIP / DEV · DETAIL
Switches Live’s bottom view between the clip and the devices; shows or hides that view.
BANQUES
The source of the banks. AUTO: your custom banks if this type of device has some, otherwise Live’s (lit when yours are in use). LIVE: Live’s. TOUS (all): every parameter of the device, 8 by 8, including those Live puts in no bank.
ÉDITER
(Edit.) The custom bank editor for this type of device, further down; lit if the device has some.

PADS page: the pad modes and the MPC-style tools

In the right-hand column. The playing tools are for DRUM and NOTE modes; the target clip is the MIDI clip playing on the selected track, otherwise the one in the slot selected in Session view.

SESSION · DRUM · NOTE
The pad mode, at the top of the column.
NOTE REPEAT
Held pads repeat at the chosen rate. Short press: on or off; long press: only while you hold it. The first hit goes out as soon as you touch the pad; the text under the button shows the rate and the timing reference (Live’s MIDI clock, “MIDI CLOCK DE LIVE”, or the BPM).
1/4 … 1/32T
The rate (T: triplet).
SWING
50% (straight), then 54, 58, 62, 66, 71 and 75% with each press: the even sixteenths are delayed · previous value.
BANDE NOTE REPEAT
The note repeat strip. Hold pads and put a finger on the strip: they repeat at the rate under your finger, even if NOTE REPEAT is off. Slide to speed up or slow down (rolls, build-ups); let go: back to the previous state and rate.
FULL LEVEL
Every pad at velocity 127.
16 LEVELS
In DRUM mode: the last note played, across the whole grid, in 16 cells of 2 × 2 pads, from velocity 8 at the bottom left to 127 at the top right. ▲ ▼: neighbouring note.
ERASE
Hold + pad: deletes every note of that pad (that pitch) from the target clip.
MUTE PAD · SOLO PAD
Hold + pad, in DRUM mode: mutes or solos the Drum Rack pad (M or S on the pad).
QUANT. REC
Live’s MIDI record quantization: none (AUCUNE), 1/4, 1/8, 1/8T, 1/16, 1/16T, 1/32; Live’s current setting is lit.
QUANTIZE · CAPTURE
Quantizes the target clip to that value (1/16 if none). CAPTURE: Live’s Capture MIDI, which recovers what you have just played without recording.
UNDO · REDO
Undo and redo in Live.

MODES tab

STOP CLIP · SOLO · MUTE · ARM · SELECT
The track button mode. STOP ALL stops every clip.
VOLUME · PAN · SEND · DEVICE · MIDI
The fader mode. SEND pressed a second time moves to the next send. DEVICE: the blue-hand device, in banks of 8 (BANK ◀ ▶). MIDI: CCs 102 to 110 on the playing channel (absolute values), for MIDI Learn.
9 FADERS
Full size, with the name, the colour and the value Live displays; the 9th is the master in every mode except MIDI.

The SHIFT layer

With SHIFT held, the buttons take on their secondary functions, written in orange on screen. SHIFT is on both pages: at the top of the scene column on the PADS page, left of the tabs on the FADERS page.

SCENES 1 TO 5
Track button mode: STOP CLIP, SOLO, MUTE, ARM, SELECT.
SCENES 6 AND 7
DRUM, NOTE (press again: back to SESSION).
SCENE 8
STOP ALL.
TRACKS 1 TO 4
Fader mode: VOLUME, PAN, SEND, DEVICE.
TRACKS 5 TO 8
▲ ▼ ◀ ▶, in steps of 8 in SESSION.
PAD
In SESSION: selects the slot without launching it. In DRUM: selects the pad in the Drum Rack.
TRACK NAMES
On the MIX tab, the global launch quantization: none, 8, 4, 2, 1 bar, 1/4, 1/8, 1/16; the current one is lit.
DEVICE TAB
Its 8 buttons pick bank 1 to 8 directly: ◀ DEVICE = 1, DEVICE ▶ = 2, ◀ BANK = 3, BANK ▶ = 4, ON / OFF = 5, LOCK = 6, CLIP / DEV = 7, DETAIL = 8.
PLAY
Resume playback.
SWING
On the PADS page: the previous value.
ARROWS · FADERS · KNOBS · BPM
Steps of 8 for the arrows; fine adjustment for the rest.

Note repeat

Worked out in the app, on a separate thread (resolution of about 1 ms). The notes leave the tablet as if you were tapping the pads: Live records them, quantized or not according to QUANT. REC.

Timing: with Sync enabled on Live’s output to the tablet, the hits follow Live’s MIDI clock: the first goes out straight away, the next ones land on Live’s grid, and the text under NOTE REPEAT reads “MIDI CLOCK DE LIVE”. Without Sync, they follow Live’s tempo starting from your first hit: steady, but not necessarily on the beat.

Velocity: with velocity by position (settings), sliding your finger on the held pad changes the strength of the next hits (lower: louder), the way you press an MPC pad more or less hard.

Note repeat, FULL LEVEL and 16 LEVELS work with any script, or with none.

PADS page in DRUM mode: the pads carry the Drum Rack names (Kick 909, Rim, Snare, Clap, Hat fermé, Hat ouvert, Crash, Ride…); NOTE REPEAT active at 1/16T at 140 BPM, a finger on the note repeat strip, the rate in pink

Custom banks

The idea comes from PrEditor 2 (Isotonik), built into GRID: no Max for Live device to add, the editor is on the tablet. FADERS page, DEVICE tab, ÉDITER (edit):

  1. Select the device in Live (blue hand). The first time for this type of device: PARTIR DES BANQUES DE LIVE (start from Live’s banks), to edit afterwards, or BANQUE VIDE (empty bank).
  2. The 8 knobs become 8 slots. Touch one to choose what it controls: empty, the track’s volume, pan or a send, a macro of the rack that contains the device, or any parameter of the device (full list with search). Nom affiché… (displayed name): your own name.
  3. + BANQUE (up to 64), RENOMMER (rename), DÉPLACER ◀ ▶ (move), COPIER and COLLER (copy, paste: the copy goes in after the current bank, on this device or another one), SUPPR. (delete, two presses), BANK ◀ ▶ to go from one bank to another.
  4. TERMINÉ (done): the source switches to AUTO and Live shows the edited bank.

The device knobs and the faders in DEVICE mode follow your banks, with your names. They apply per type of device: all your Operators share the same ones; for plug-ins, racks and Max for Live devices, it goes by name. A parameter is found by its original name: if a plug-in changes its parameter list, the slot of a parameter that has gone stays empty.

They are stored on the tablet and sent back to the script when the device appears. Réglages → Exporter / Importer (settings → export / import: a text file, to keep on the computer or in the cloud; an import replaces the banks of the same devices and keeps the others) / Effacer (clear).

The bank editor on Acid Lead: bank PERFO 2/2, with Filtre and Env Mod (parameters), Réverbe and Delay (track sends), Delay interne, an empty slot, the track’s Pan and Niveau (level); 2.1 screenshot, all on one screen

2.1 screenshot, all on one screen

The overview

VUE ENSEMBLE (overview), below the grid in SESSION mode, transforms the grid: each pad stands for a block of 8 tracks × 8 scenes of your set, up to 64 tracks × 64 scenes, with its track (P) and scene (S) numbers.

  • clips are playing in this block
  • clips, none playing
  • empty
  • the block on display

Tap a block: the grid goes there and the normal view returns. Pressing VUE a second time cancels.

On the APC40 mk2, this view is reached with SHIFT + grid; here, SHIFT + pad keeps its 1.0 function, selecting a slot, hence the dedicated button.

Overview: the grid shows blocks of 8 tracks × 8 scenes numbered P 1-8 S 1-8, P 9-16 S 1-8…, in green, red or dark, the block on display outlined in orange; 2.1 screenshot, all on one screen

2.1 screenshot, all on one screen

Playing: DRUM and NOTE modes

The pads play notes on the playing channel (1 by default, 1 to 15 in the settings), to the track selected in Live, which is armed automatically (adjustable). Fixed velocity (110 by default) or according to the finger’s position on the pad: lower, louder. FULL LEVEL, 16 LEVELS and note repeat are on the PADS page.

DRUM

4 blocks of 16 pads lined up with a Drum Rack, starting with the bottom-left block (C1 = note 36), then bottom right, top left, top right.

With the selected track’s Drum Rack, each pad shows the name and colour of the Live pad, M or S if it is muted or soloed, and the selected pad is outlined. SHIFT + pad selects the pad in Live: the DEVICE tab follows its instrument.

NOTE

A keyboard in fourths: each row goes up a fourth. Two layouts: in key, each column is a scale degree, with no wrong notes; chromatic, each column is a semitone and out-of-scale notes are dimmed.

Roots in purple. 17 scales plus chromatic (major, minor, modes, harmonic and melodic minor, pentatonics, blues, Phrygian dominant, Hungarian minor, double harmonic, hirajoshi, whole tone). C minor by default, C2 at the bottom left, octave from −3 to +3.

On screen

FADERS page, DEVICE tab: Acid Lead, Banque 1, knobs Cutoff, Résonance, Env Mod, Decay, Accent, Drive, Delay and Reverb with their values, ON / OFF, LOCK, CLIP / DEV, DETAIL, BANQUES (AUTO) and ÉDITER buttons, the faders below
The DEVICE tab. The device’s 8 parameters, with their names and the values Live displays; the faders stay below.
FADERS page, MODES tab: track buttons in MUTE mode, faders in PAN mode, shown full size
The MODES tab. The 1.0 mode rows and the full-size faders, here in PAN, with the track buttons in MUTE.
The PADS page at the size of a Galaxy S23 in landscape
On a Galaxy S23. The PADS page in landscape…
The FADERS page, MIX tab, at the size of a Galaxy S23 in landscape
… and the FADERS page, MIX tab.
A custom bank in use: PERFO 2/2 on Acid Lead, PERSO label, knobs Filtre, Env Mod, Réverbe, Delay, Delay interne, Pan and Niveau; BANQUES AUTO and ÉDITER buttons; 2.1 screenshot, all on one screen
A custom bank in use. PERFO 2/2 on Acid Lead: device parameters, sends, the track’s pan and level, with your names. 2.1 screenshot, all on one screen
Bank editor, first time for Acid Lead: PARTIR DES BANQUES DE LIVE (start from Live’s banks) or BANQUE VIDE (empty bank); 2.1 screenshot, all on one screen
The starting point. The first time for a type of device: start from Live’s banks, or from an empty bank. 2.1 screenshot, all on one screen
16 LEVELS: the grid split into 16 cells of 2 × 2 pads, from velocity 8 to 127, for note C#1; 2.1 screenshot, all on one screen
16 LEVELS. The last note played, across the whole grid, from velocity 8 at the bottom left to 127 at the top right. 2.1 screenshot, all on one screen
SHIFT held: fader modes on the track buttons, track button modes on the scene buttons, global quantization on the track names, REPRISE instead of PLAY, in orange; 2.1 screenshot, all on one screen
SHIFT held. The secondary functions in orange: fader and track button modes, global quantization on the track names, REPRISE (resume) instead of PLAY. 2.1 screenshot, all on one screen
NOTE mode: keyboard in fourths, roots in purple, a pad being played in green; 2.1 screenshot, all on one screen
NOTE mode. A keyboard in fourths, here in A minor: roots in purple, the pad being played in green. 2.1 screenshot, all on one screen
The 2.1 layout: the grid on the left, the MIX page on the right with the knobs, each track’s buttons, 9 faders and the crossfader
The 2.1 layout, still available: Réglages › Interface › “Pads et faders sur le même écran”. The grid on the left, the MIX, DEVICE, PADS and MODES pages on the right.
App message: Live: SOMA23 Keys answers, not SOMA23 Grid, with what to do; 2.1 screenshot, all on one screen
Only SOMA23 Keys answers. The app says what to set in Live; DRUM and NOTE already play, without the script. 2.1 screenshot, all on one screen
App message: tablet not connected over USB MIDI, with what to do; 2.1 screenshot, all on one screen
Tablet not connected. A USB data cable, then “MIDI” in the tablet’s USB notification. 2.1 screenshot, all on one screen

Scroll to see the other screenshots.

Install and connect

Two things to install: the app on the tablet, and, once and for all, the script in Live. Already on 2.1? App 2.2 installs over it and keeps your settings and custom banks; the script doesn’t change, nothing to do in Live. Coming from 1.0 or 2.0? Also replace the script folder with the 2.1 one, which 2.2 uses, and restart Live, without changing anything in its preferences.

  1. Install the APK on the tablet: open it and allow the installation if Android asks. On MIUI or HyperOS, a security scan starts: that’s normal outside the Play Store. If 1.0, 2.0 or 2.1 is installed, 2.2 installs over it (same signature) and keeps your settings and custom banks. On first launch after the update, a message introduces the two pages; its “Disposition 2.1” button keeps the old layout. It installs alongside SOMA23 KEYS: they are two separate apps. Plan B: adb install -r SOMA23-GRID-v2.2.apk from the computer.
  2. Connect the tablet to the computer with a USB data cable, then choose MIDI in the USB notification. Automatic every time you plug in: Developer options → Default USB configuration → MIDI (shortcut in the app’s settings). The badge at the top shows “USB MIDI”. Only one app at a time can hold the port: close SOMA23 KEYS, SOMA23 DECK or TouchOSC if they are open.
  3. Install the script, once; 2.2 uses script 2.1, nothing to do if it is already installed. Unzip it and you get a SOMA23_Grid folder (4 .py files). Copy it into the Remote Scripts folder of your User Library, next to SOMA23_Keys if it is already there; if a SOMA23_Grid folder is already there, replace it entirely:
    • Windows: Documents\Ableton\User Library\Remote Scripts\
    • macOS: ~/Music/Ableton/User Library/Remote Scripts/
    If you have moved your User Library, its location is in Preferences → Library. Restart Live.
  4. In Live, Preferences → Link, Tempo & MIDI (nothing to change if an earlier version was already set up): Control Surface SOMA23 Grid in a free slot, with the tablet as input and output. SOMA23 Keys already set up? Leave it in its slot, on the same tablet. The tablet’s MIDI ports: on the input, Track enabled (that’s what makes DRUM and NOTE modes play); Remote only for MIDI Learn (MIDI faders, USER knobs). Optional, for note repeat: on the output, Sync enabled, so that Live sends its MIDI clock to the tablet. The tablet is the same MIDI device as for SOMA23 KEYS.
  5. You’re ready when the badge shows “LIVE” and “script 2.1” (for example “LIVE 12 · script 2.1” with Live 12) and the grid fills up. In Live’s Session view, a coloured frame surrounds the 8 tracks × 8 scenes on display. “script 2.0 → 2.1” (or “1.0 → 2.1”): the old script is answering; what it knows works, and the newer functions show “installe le script 2.1” (install script 2.1), except note repeat, FULL LEVEL and 16 LEVELS, which are in the app. “LIVE : SOMA23 Keys seul”: Live answers but the GRID script isn’t added yet; go back to step 4.

With SOMA23 KEYS, and without Ableton

Both scripts together

GRID uses channel 16 notes and CCs that KEYS doesn’t listen to, and vice versa; versions 2.0 and 2.1 only add new ones among the free numbers. Both scripts can stay loaded on the tablet’s port, and each app ignores the other script’s messages. Checked by test: none of the KEYS CCs sent to the GRID script has any effect. The 2.1 additions, notes and SysEx, don’t concern the Keys script, which only handles channel 16 CCs.

The only cross-effect: the KEYS script automatically arms the selected MIDI track, even when GRID is the app that’s open. In SESSION, that track’s empty slots then become record buttons (red ○): a press records a clip instead of stopping the track. If that bothers you, set SOMA23 Keys’ slot to None while you work with GRID. Turning off automatic arming in the SOMA23 KEYS settings also works, but the Keys script turns it back on every time Live starts, until the KEYS app next connects.

Both scripts move the blue hand onto the selected device: no conflict, it’s the same device.

Without the script

DRUM and NOTE modes, with note repeat, FULL LEVEL and 16 LEVELS, the MIDI faders and the USER knobs work with any software. The commands that control Live stay greyed out as long as the script doesn’t answer.

The tablet sends nothing on channel 16 without its answer, except its HELLO message, placed on a CC left undefined by the MIDI standard and with no effect on an instrument. A troubleshooting option forces sending.

What was taken from the models, and what wasn’t

The APC40 mk2

8 × 8 grid: the 1.0 grid, kept; the original has 8 × 5.

Overview through a button rather than SHIFT + grid.

Tempo set by sliding on the BPM rather than with a knob, with NUDGE on either side.

USER mode for the knobs: fixed CCs (111 to 118) to learn in Live, instead of the original’s own “user” mode.

Pedal input: no equivalent; the original’s manual gives it no function in Live.

PrEditor 2

Taken: up to 64 banks of 8 per device, renaming banks and parameters, access to parameters missing from Live’s banks, mixing in the track’s volume, pan and sends and the rack’s macros, empty slots, copy, paste, move, saving and sharing.

Not taken: PrEditor is a Max for Live device that serves every Live surface (Push, etc.); here, the banks only serve GRID, as a Live script can’t change the other surfaces’ banks.

MPCs

Taken: note repeat with triplets and swing, FULL LEVEL, 16 LEVELS, ERASE, pad mute and solo, record quantization, clip quantization, capturing what you have just played, undo and redo, classic MPC playing functions; plus a touch strip for note repeat.

Not taken, out of reach for a Live controller or already covered: the step sequencer (Live has its own, and the grid is for clips), sampling and chopping, performance effects, pressure sensitivity (a touch screen doesn’t measure it: the finger’s position serves as velocity), standalone operation.

Troubleshooting

“USB —” badge: tablet USB mode set to “MIDI”, a data cable, and no other MIDI app open on the tablet.

“LIVE : en attente du script” (waiting for the script): the SOMA23_Grid folder in the right place, with the 4 .py files directly inside; Live restarted; Control Surface with the tablet as input and output.

“script 2.0 → 2.1” (or “1.0 → 2.1”): replace the SOMA23_Grid folder with the 2.1 one, then restart Live.

“LIVE : SOMA23 Keys seul” (Keys only): the Keys script answers but Grid doesn’t. Add “SOMA23 Grid” in another Control Surface slot.

Note repeat isn’t on Live’s beats: enable Sync on Live’s output to the tablet; the text under NOTE REPEAT changes to “MIDI CLOCK DE LIVE”.

Custom banks don’t apply: BANQUES on AUTO, the same type of device (for a plug-in: the same name), and script 2.1.

DRUM / NOTE pads don’t play: the tablet’s input with Track enabled, a MIDI track selected (automatic arming), and the playing channel not filtered on the track.

A press on an empty slot records: the track is armed, by hand or by SOMA23 KEYS’ automatic arming (see above).

The USER knobs do nothing: MIDI Learn in Live (Ctrl+M), with Remote enabled on the tablet’s input.

The script doesn’t load: Live’s Log.txt file (Windows: %APPDATA%\Ableton\Live x.x.x\Preferences\) contains the “SOMA23 Grid” lines.

A note gets stuck: Réglages → PANIQUE (settings → panic), which also stops note repeat.

No faders, or no grid, on screen: the FADERS (or PADS) button at the top right. To have everything on one screen, as in 2.1: Réglages › Interface › “Pads et faders sur le même écran”.

MIDI port already in use on Windows: only one program at a time per port (rekordbox, another DAW…).

The protocol between the tablet and the script (version 3)

Each version keeps every message of the previous ones and adds new ones: v2 for 2.0, v3 for 2.1 (custom banks, MPC-style functions); 2.2, with its two pages, changes nothing in the protocol and speaks version 3, with script 2.1. The app recognises the script’s version by its HELLO: with an older script, what it knows works, and the newer functions show “installe le script 2.1” (install script 2.1) instead of sending anything. Note repeat, FULL LEVEL and 16 LEVELS stay in the app (playing channel notes): they work with any script, or with none.

Tablet → Live

Playing channel (1 to 15): DRUM and NOTE mode notes, note repeat included; faders in MIDI mode: absolute CCs 102 to 110; v2 track knobs in USER mode: absolute CCs 111 to 118. Channel 16: everything else, passed to the script by Live (these messages don’t reach the tracks). The app sends nothing on channel 16 until the script has answered, except HELLO, repeated every 2 s.

Notes (channel 16)Element
0–63grid pads, row × 8 + column, row 0 at the top; during the overview (note 91 held): jump to block row × 8 + column
64–71scene buttons 1 to 8
72–79track buttons 1 to 8
80 / 81v2arrangement / session record (toggle)
82 / 83v2NUDGE − / + (active while the note is held)
84v2resume playback (SHIFT + PLAY)
85 / 86v2previous / next device on the selected track
87 / 88v2device ON / OFF; lock to the device (LOCK)
89 / 90v2detail view: clip ↔ devices; detail view shown / hidden
91v2overview (held: active)
92 / 93v3undo / redo
94v3Capture MIDI
95v3quantize the target clip (to the record quantization, 1/16 if none)
96v3ERASE: delete from the target clip every note of pitch velocity − 1
97 / 98v3mute / solo of the Drum Rack pad with note velocity − 1 (toggle)
99v3MIDI record quantization, velocity − 1 = none, 1/4, 1/8, 1/8T, 1/16, 1/16T, 1/32

Notes: 9F nn 7F on press, 8F nn 00 on release; for notes 96 to 99, the value is carried by the velocity (value + 1, so that it is never 0). Pads and scenes act on press and on release (“held button” launching: Gate, Toggle modes…); the other buttons act on press. Target clip: the MIDI clip playing on the selected track, otherwise the one in the slot highlighted in Session view. Relative CC values: two’s complement (1..63 = +n, 65..127 = −(128 − n)); 1,000 ticks = a parameter’s full travel, 10,000 with SHIFT.

CC (channel 16)FunctionValue
1–5, 7–9v2device knobs 1 to 8relative
10 / 11v2cue (headphone) level / crossfaderrelative
12–19v2track knobs 1 to 8 (PAN or send)relative
33–41faders 1 to 8 + masterrelative
42SHIFT127 held / 0 released
43track button mode0 stop clip, 1 solo, 2 mute, 3 arm, 4 select
44fader mode0 volume, 1 pan, 2 send, 3 device
45faders: next send127
46pad mode0 session, 1 drum, 2 note
47STOP all clips127
64 / 65v2knob touched / released (gesture start / end)knob number
66v2knob to its default valueknob number
67v2strip actionaction × 8 + column
68v2temporelative: 1 tick = 0.1 BPM (0.01 with SHIFT)
69v2track knob mode0 PAN, 1 SENDS, 2 USER, 3 next send
70–78faders: touch127 touched, 0 released, 64 default value
79–82▲ ▼ ◀ ▶: move the session ring127 = 1 step (8 with SHIFT); v21 to 64 = that many steps (BANK sends 8)
83 / 84BANK ◀ / ▶: device parameter bank (v2whatever the fader mode)127
89HELLOthe app’s protocol version
90automatic arming (drum and note modes)127 / 0
91select a Drum Rack padpad note
92–95PLAY, STOP (when stopped: back to the start), METRO, TAP tempo127

Knob number (CC 64 to 66 and SysEx 28): 0–7 track, 8–15 device, 16 cue, 17 crossfader.

Action (CC 67)Effect, column 0–7 = ring track unless stated
0select the track
1 / 2 / 3mute / solo / arm (toggle; solo and arm exclusive according to Live’s preferences)
4crossfader assignment: none → A → B → none
5stop the track’s clips
6global quantization, column = none, 8, 4, 2, 1 bar, 1/4, 1/8, 1/16
7track knobs on send number column
8select the master (column ignored)
9device bank number column
10v3source of the device’s banks, column = 0 AUTO, 1 LIVE, 2 TOUS (all)

v3 SysEx from the tablet to Live, F0 7D 24 <command> <data> F7, same encoding as in the other direction, received by the script (to be confirmed in a real Live, see below): 40 start of banks (device type key, number of banks), 41 bank (number, name), 42 slot (bank, slot 0–7, type: empty, parameter, volume, pan, send or parent rack macro, index, original name, label), 43 end of banks, 44 request for the parameter list, 45 bank on display. The script only keeps the banks until the next connection: the app sends them again when the device appears.

Live → tablet

SysEx F0 7D 24 <command> <data> F7 (7D: ID reserved for non-commercial use; 24: SOMA23 GRID, SOMA23 KEYS being 23). Integers on 7, 14 or 21 bits, Live colour on four 7-bit bytes, texts terminated by 00. The script reads the state every 100 ms and only sends the messages that have changed, at most 48 per pass; during a gesture on a fader or a knob, its values are read again on every message received.

CmdNameData
01–04HELLO, MESSAGE, PING, BYEprotocol, script and Live versions / text shown for 1.6 s / script present, every second (with no news for 3.5 s, the app considers Live absent) / script unloaded
10 / 11TRANSPORT / POSITIONplayback, recordings, loop, metronome, v2global quantization, tempo, time signature, v3MIDI record quantization / bar, beat, sixteenth
20RINGfirst track and first scene on display, counts, modes, automatic arming, Session view, v2master selected, v2overview active, selected track and scene
21TRACKcolumn, type (MIDI, audio, group, return), mute, solo, armed, armed automatically, selected, armable, clip playing, stop triggered, frozen, v2side A, v2side B, colour, name
22SCENErow, present, triggered, selected, empty, colour, name
23SLOTpad 0–63, state (empty, stopped, triggered, playing, recording…), group slot, highlight, colour, name
24 / 25FADER / FADER PAGEpresent, quantized, bipolar, disabled, value, colour, name, value as displayed by Live / mode, current send, number of return tracks, bank and number of banks, title, subtitle
26 / 27DRUM MAP / DRUM PADDrum Rack present, selected pad, filled, muted and soloed pads / a pad’s colour and name
28 / 29v2KNOB / KNOB PAGEnumber 0–17, then as FADER / mode (PAN, SENDS, USER), current send, number of return tracks, title, subtitle
2Av2DEVICEpresent, on, locked, neighbouring devices and banks, detail view shown, clip view, v3custom banks in use, position in the chain and number of devices, bank and number of banks, track colour, device, bank and track names
2Bv2OVERVIEWcolumns, rows, then one byte per block of 8 tracks × 8 scenes: empty, clips, clips playing; sent every 500 ms while note 91 is held
2C / 2Dv3PARAMETER / LIVE BANKone message per parameter of the device (index, count, original name, displayed name) / the device’s Live banks (number, count, name, 8 parameter indexes), to start from them
2E / 2Fv3LIST HEADER / DEVICE KEYnumber of sends, of parent rack macros and of parameters, rack name, device type key / bank source (AUTO, LIVE, TOUS) and key, sent with DEVICE

Messages 2C, 2D and 2E are only sent on request (command 44), in one go, outside the 48-message budget. If Live’s output to the tablet has Sync enabled, the app also receives the MIDI clock (F8, FA, FB, FC, position F2) and locks note repeat to it. SOMA23 KEYS uses CCs 20–31, 48–63, 85–87 and 102–119 on channel 16 and no notes on that channel: both scripts can stay loaded on the same port without reacting to the other app’s messages.

Where version 2.2 stands

Checked at build time

  • The script against a simulated Live, built from Live 11 and 12’s official scripts: 228 checks, passed twice (linear parameter banks, then Live 12.4’s native banks), including 5,000 random messages without a single exception; every SysEx under 128 bytes, even with very long names, accents and emoji; coexistence with SOMA23 Keys; custom banks and the MPC-style functions, including ERASE with Live 10’s API.
  • Protocol consistency between the script and the app (191 constants), with no CC shared with SOMA23 Keys.
  • The script’s syntax compatibility with Python 2.7 and 3.
  • The app: 196 checks. The 154 from 2.1, run in the 2.1 layout: everything that existed in 2.0, plus the banks and their export / import, the editor, note repeat on the internal clock and on a simulated MIDI clock (rates, triplets, swing, touch strip, momentary mode, finger velocity), FULL LEVEL, 16 LEVELS, ERASE, pad mute and solo, QUANT. REC, and behaviour with a 2.0 script. And 42 for 2.2: the controls of each page, none overlapping or off screen (16:10, Galaxy S23, 4:3, for the PADS page and each of the MIX, DEVICE and MODES tabs), the PADS and FADERS buttons, launching a clip, a fader, ERASE, note repeat and the touch strip on the new pages, a held pad released when switching pages, the page kept in the settings, the 2.1 settings carried over and the all-on-one-screen option.
  • Nothing broken in the 2.1 layout: the 18 screenshots from 2.1 are identical to the pixel, and what the app sends to the script during the tests is identical to the byte.
  • End to end: what the app actually sent during these tests, replayed into the real script (11 checks: banks received and resolved, bank on display, notes erased from the right clip, quantization, undo).
  • The APK, built and signed (v1, v2, v3) with the same key as 1.0, 2.0 and 2.1.

Still to confirm in real use

  • The two 2.2 pages on the real tablet, while playing: the size of the pads and faders, where the PADS and FADERS buttons sit, and the update, on Android 10 and later, of the edges where the “back” gesture is disabled, at each page switch.
  • Running in a real Live, in particular the name shown in the Control Surface list, and functions used by Ableton’s official scripts but undocumented: the session frame, “held button” launching and automatic arming.
  • The script receiving the SysEx sent by the tablet (custom banks): the official scripts receive their controllers’ replies this way, but it hasn’t been checked with Live.
  • Live functions used by the PADS page: quantizing a clip, Capture MIDI (Live 11 and later), deleting notes (Live 11 and later, with a fallback for Live 10).
  • The plug-in key: if Live renames the instance, its custom banks may no longer recognise it.
  • LOCK: the script asks Live to lock, as the official scripts do; if Live doesn’t respond, the script locks its knobs itself, without the padlock shown in Live.
  • Both surfaces, Keys and Grid, on the same port in Live: designed for it, with no shared message, but not yet checked in Live.
  • Live 10 (Python 2): the script is written for it, but hasn’t run on it yet.
  • The actual latency between the tablet and Live, and how steady note repeat is on the tablet.
  • The step size of SHIFT + arrows: 8 here; the APC mini mk2 manual doesn’t specify it.

Original Soma23 design, with no Akai or Isotonik brand or graphic element. Ableton and Live are trademarks of Ableton AG; Akai, APC, MPC, Isotonik and PrEditor are trademarks of their respective owners; SOMA23 GRID is an independent project, not affiliated with them. Michroma font: SIL Open Font License.