SOMA23 KEYSAndroid app · version 1.0

SOMA23KEYS

A control keyboard for Ableton Live, on your tablet. 32 keys, 8 encoders, the transport and a screen, connected to the computer as native USB MIDI. The included script shows the track, the clip and the device parameters; scales, chords and an arpeggiator are built in.

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

SOMA23 KEYS: transport buttons on the left, a screen with the Acid Lead track and 8 parameters, 8 encoders, a 4-way encoder, PITCH and MOD strips, a 32-key keyboard

The app rendered at the Xiaomi Pad 5 resolution, with a demo set

The tablet, Live, and nothing in between

Like SOMA23 DECK, the app uses Android’s “MIDI” USB mode: plugged into the computer, the tablet becomes a MIDI keyboard. A small script installed in Live does the rest.

Native USB MIDI

Windows sees the tablet as a standard USB MIDI keyboard, with no driver. Notes, pitch bend, modulation and sustain go out on the playing channel; the controls go out on channel 16, which Live passes to the script.

A script for Live

The control surface script reads the state of the set every 100 ms and only sends what changes: track, scene, highlighted clip, tempo, position, transport, and the 8 parameters lined up with the encoders.

Smart Play

17 scales plus chromatic, chords built within the scale or fixed, and an arpeggiator locked to Live’s MIDI clock.

The surface

Holding SHIFT gives access to the secondary functions, written in orange below and on the buttons. The labels are those shown in the app.

Transport and editing

SCALE · ARP
Scale and chords, or the arpeggiator, on or off. Long press or SHIFT: their settings on the 8 encoders.
UNDO
Undo · REDO.
QUANTIZE
Quantizes the displayed MIDI clip (Live’s record quantization grid, 1/16 by default) · CAPTURE MIDI.
AUTO
Automation arm · re-enable automation.
LOOP
Arrangement loop · MIDI OVERDUB.
METRO · TEMPO
Metronome. TEMPO: tap tempo; held + 4D encoder: ±1 BPM (SHIFT: ±0.1).
PLAY
Play / stop, like the space bar · from the start.
REC
In Session view: session record · arrangement. In Arrangement view: the other way round.
STOP
Stop (when stopped: back to the start) · stop all clips.

Screen and encoders

SCREEN
Track (colour, MIDI or audio, armed), scene, highlighted clip, tempo, position, transport, then the 8 parameters lined up with the encoders.
8 ENCODERS
Endless: sliding up increases, touching shows the value in large type, double-tap restores the default value, SHIFT gives fine adjustment.
DEVICE
The device with the blue hand, in banks of 8: Live’s native banks for its own devices, macros for racks.
MIXER
Volumes of 8 tracks; press again: panning.
PISTE
Track mode: volume, pan and sends of the selected track.
MIDI
Free CCs 102 to 109 (playing channel, absolute values) for MIDI Learn.
PAGE ◀ ▶
Parameter bank (DEVICE), track bank (MIXER) or send bank (PISTE).
4D ENCODER
Turn: track · scene. Tap: launch the clip · the scene.
▲ ▼ ◀ ▶
Scenes; previous / next device (DEVICE) or bank of 8 tracks (MIXER) · ARM, STOP the track’s clips, MUTE, SOLO.

Playing

KEYBOARD
32 keys from C to G, multitouch, glissando, velocity according to the finger’s height on the key (lower: louder).
OCT − / +
Octave, from −3 to +3 · transpose. Both together: reset.
PITCH
14-bit pitch bend, springs back to centre on release.
MOD
Modulation (CC1 by default; CC11, CC74 or CC2 to choose from), stays in place; double-tap: 0.
SUST · VEL FIX
Latched sustain (CC64). Fixed velocity, with value and curve in the settings.

The selected MIDI track is armed automatically, as with Push: you pick a track with the encoder and play. If you arm a track by hand, automatic arming steps back. Adjustable in the settings.

Smart Play

Scale, chords and arpeggiator are set on the 8 encoders, with a long press on SCALE or ARP.

Scales

17 scales plus chromatic, any root: major, minor, modes, harmonic and melodic minor, pentatonics, blues, Phrygian dominant, Hungarian minor, double harmonic, hirajoshi, whole tone.

GUIDÉ (guided): an out-of-scale key plays the scale note just below. HORS GAMME MUET (out-of-scale muted): it plays nothing. FACILE (easy): the white keys play the scale in order, the black keys are muted, and each key carries the name of its note.

Chords

HARMO 3 or HARMO 7: a 3- or 4-note chord built within the scale. Or a fixed chord: major, minor, sus2, sus4, 7, maj7, min7, add9, min9, fifth, fifth + octave, octave.

Voicing: normal, 1st or 2nd inversion, or open.

Arpeggiator

Up, down, up-down, down-up, as played, random, chord. Rates from 1/4 to 1/32, triplets included; 1 to 4 octaves; gate; swing from 50 to 75%; latch; played or fixed velocity.

It locks to Live’s MIDI clock when Live is playing, and then starts on the next division. Otherwise it follows Live’s tempo, or its own internal tempo when Live isn’t there.

On screen

SCALE page: root A, minor scale, guided mode, HARMO 3 chord, settings in blue on the encoders
Scale and chords. A minor, GUIDÉ mode, HARMO 3 chords: the settings move onto the encoders.
ARP page: up pattern, 1/16 rate, 60% gate, 50% swing, locked to Live’s tempo
The arpeggiator. Pattern, rate, octaves, gate, swing, latch, velocity and tempo, one per encoder.
FACILE mode: the white keys carry the names of the notes of the A minor scale
FACILE mode. The white keys play the scale in order and carry the name of their note.
MIXER page: volumes of 8 tracks in Live’s colours
MIXER. The volumes of 8 tracks, in their Live colours; press again to switch to panning.
A touched encoder: the value of the Cutoff parameter shown in large type
Encoder touched. The parameter’s value is shown in large type, as Live writes it.
The app stretched across the wide screen of a Galaxy S23 in landscape
On a wide screen. The surface stretches, here at the size of a Galaxy S23 in landscape.

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.

  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. Plan B: adb install SOMA23-KEYS-v1.0.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 DECK or TouchOSC if they are open.
  3. Install the script: unzip it and you get a SOMA23_Keys folder (4 .py files). Copy it into the Remote Scripts folder of your User Library, creating that folder if it doesn’t exist:
    • 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: Control Surface SOMA23 Keys, with the tablet as input and output. The tablet’s MIDI ports: on the input, Track enabled (that’s what makes the notes play); Remote only for MIDI Learn; on the output, Sync enabled to lock the arpeggiator to Live.
  5. You’re ready when the badge shows “LIVE” followed by your Live version and “script 1.0”, and the screen shows the selected track.

Without Ableton, too

The keyboard, the strips, the sustain, the arpeggiator and MIDI mode work with any software: the notes go out on the playing channel (1 by default, adjustable from 1 to 15). The buttons that control Live stay greyed out as long as the script doesn’t answer, and the tablet sends nothing on channel 16 without its answer, so as not to send stray controller messages to an instrument. A troubleshooting option forces sending.

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_Keys folder in the right place, with the 4 .py files directly inside; Live restarted; Control Surface with the tablet as input and output.

The notes 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.

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

A note gets stuck: Réglages → PANIQUE (settings → panic).

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

Tablet → Live

Notes, pitch bend, modulation (CC1 by default) and sustain (CC64): on the playing channel, 1 to 15. MIDI mode: absolute CCs 102 to 109 on the playing channel. Controls: Control Change on channel 16 (BF cc vv), all passed to the script by Live. Buttons: 127 on press, 0 on release. Relative: two’s complement, 1 to 63 = +n, 65 to 127 = −(128 − n).

CCFunctionCCFunction
20PLAY (play / stop)1064D encoder: rotation (relative)
21RESTART1074D encoder: PUSH (launches the clip)
22REC108SHIFT + PUSH (launches the scene)
23REC ALT.109 / 110▲ / ▼ (scenes)
24STOP111 / 112◀ / ▶ (device, track bank or track depending on the mode)
25STOP all clips113 / 114PAGE ◀ / ▶
26LOOP115ARM (selected track)
27MIDI OVERDUB116STOP the track’s clips
28METRO117MUTE
29TEMPO (tap; held + 4D rotation = tempo)118SOLO
30UNDO119HELLO (value = the app’s protocol version)
31REDO85MODE (0 device, 1 volume, 2 pan, 3 track, 4 MIDI)
102QUANTIZE86SHIFT (127 / 0)
103CAPTURE MIDI87automatic arming (127 / 0)
104AUTO (automation arm)48–55encoders 1 to 8: rotation (relative)
105re-enable automation56–63encoders 1 to 8: touch (127), release (0), default value (64)

Live → tablet

SysEx F0 7D 23 <command> <data> F7 (ID 7D, reserved for non-commercial use). The script sends a PING every second; with no news for 3.5 s, the app considers Live absent.

CmdNameData
01HELLOprotocol, script version, Live major version
02MESSAGEtext shown for 1.6 s
03 / 04PING / BYEscript present, script unloaded
10TRANSPORTplayback, recordings, loop, metronome, automation, overdub, view, auto-arm, undo / redo, tempo, time signature
11POSITIONbar, beat, sixteenth
20TRACKindex, count, type, flags (armed, mute, solo…), colour, name
21SCENEindex, count, colour, name
22CLIPstate of the highlighted slot, colour, name
30PAGEmode, bank, devices, colour, title, subtitle
31SLOTencoder number, flags, normalised value, colour, name, value as displayed by Live

Where version 1.0 stands

Checked at build time

  • The script against a simulated Live, built from Live 11 and 12’s official scripts: 308 checks, including 4,000 random messages without a single exception; native banks tested with Live 12.4’s bank file.
  • The script’s syntax compatibility with Python 2.7 and 3.
  • The app: 107 checks (MIDI reading, note engine, scales, chords, arpeggiator in simulated time and locked to a MIDI clock, touch gestures, dialogue with the script by replaying its SysEx), and the screenshots.
  • The APK, built and signed (v1, v2, v3).

Still to confirm in real use

  • Running in a real Live, in particular the name shown in the Control Surface list and automatic arming.
  • Live 10 (Python 2): the script is written for it, but hasn’t run on it yet.
  • Whether Live sends MIDI clock while the transport is stopped (the app handles both cases).
  • The actual latency between the tablet and Live.

Original Soma23 design, with no brand or graphic element from any manufacturer. Ableton and Live are trademarks of Ableton AG; SOMA23 KEYS is an independent project, not affiliated with Ableton. Michroma font: SIL Open Font License.