Erste Einrichtung

Installation

Die App ist ein fertig gebautes Programm für Apple-Silicon-Macs (M-Prozessoren). Kein Node.js, kein npm install, kein Terminal-Wissen nötig.

Was du bekommst

Der Ordner Programm (nicht anfassen) muss so bleiben, wie er ist — node_modules darin enthält die MIDI-Anbindung für die Bedienung einzelner Looper aus dem Browser.

1 Remote Script kopieren

Den Ordner Zum Kopieren/Remote Scripts/LooperDisplay nach

~/Music/Ableton/User Library/Remote Scripts/

kopieren. Hast du zusätzlich ein Roland SPD-SX PRO, den Ordner Zum Kopieren/Remote Scripts/SPD_SX_Pro_Looper gleich mit dorthin.

2 Ableton Live einrichten

1. Live starten (oder neu starten, falls es schon offen war — Remote Scripts werden nur beim Programmstart eingelesen).
2. Einstellungen → Link, Tempo & MIDI öffnen.
3. In einer freien Zeile der Bedienoberflächen LooperDisplay auswählen.

✅ Ohne eigene Hardware bleiben Eingang und Ausgang auf „Kein" — ein KORG nanoKONTROL2 ist optional. Auch ohne angeschlossenes Gerät liefert das Script trotzdem alle Daten für die Anzeige.

3 App starten

Im Finder zu diesem Ordner wechseln und dort doppelklicken auf Looper-Display starten.command.

1. Beim allerersten Mal blockiert macOS das mit „kann nicht geöffnet werden, da der Entwickler nicht verifiziert werden kann". Das ist normal bei selbst gebauten Programmen ohne teures Apple-Zertifikat.
2. Im Finder mit Rechtsklick auf die Datei → „Öffnen" → im Dialog noch einmal „Öffnen" bestätigen. Das genügt einmalig, danach funktioniert der normale Doppelklick.
3. Kurz erscheint ein Terminal-Fenster, minimiert sich dann von selbst, und ein Browser-Tab mit der Anzeige öffnet automatisch.

Beim allerersten Start fragt macOS zusätzlich einmalig, ob „osascript" das Terminal steuern darf — dafür wird das Fenster minimiert und später wieder geschlossen. Bitte erlauben. Ohne diese Erlaubnis läuft die App trotzdem, das Fenster bleibt dann nur offen.

Für ein Tablet zusätzlich die zweite, im (minimierten) Terminal-Fenster angezeigte Adresse dort in Safari öffnen:

Anzeige: http://localhost:8080
         http://192.168.0.XXX:8080  (für Tablet/Handy)

4 Auf dem Tablet einrichten (optional)

Für eine Anzeige ganz ohne Browser-Oberfläche: die zweite Adresse in Safari öffnen, Teilen-Symbol → „Zum Home-Bildschirm" — nicht „Zu Lesezeichen hinzufügen". Danach startet die Seite über das neue Symbol komplett ohne Adressleiste.

Wie beendest du es wieder?

Im Finder doppelklicken auf Looper-Display beenden.command — findet und beendet die App, auch wenn das (minimierte) Terminal-Fenster längst aus den Augen ist. Zwei weitere, gleichwertige Wege: ⏻ Server beenden oben rechts in der Anzeige selbst, oder Ctrl + C im (wieder eingeblendeten) Terminal-Fenster.

Schließt du nur den Browser-Tab mit der Anzeige, läuft die App im Hintergrund weiter — das ist meistens gewollt, falls ein Tablet die Seite dauerhaft offen halten soll.

Wenn die App läuft

Bedienung

Die Ringe

Jeder Looper hat zwei Ringe: außen der Fortschritt über die ganze Loop-Länge mit einer Marke pro Takt, innen eine Torte, die sich einmal pro Takt füllt. In der Mitte steht Takt / Takte und der Zustand.

Steuerung im Browser

• Inneren Kreis tippenTransportknopf des Loopers — Record, Play oder Overdub, je nach Zustand
• Zweimal schnell tippenstoppt den Looper — Ableton behandelt zwei rasche Klicks selbst als „Doppelklick zum Stoppen"
• Inneren Kreis halten (0,6 s)Taktzahl von Hand durchschalten (1, 2, 4, 8, 16), wenn die Länge unbekannt ist
• Ecktaste STOPunten links am Ring — derselbe Stop, als eigene Taste
• Ecktaste CLEARunten rechts am Ring — Looper löschen
• Taste F / Button „Vollbild"Vollbild an/aus
• Taste RLooper im Set neu suchen, nach einem Umbau
• „⏻ Server beenden"beendet den Node-Server, nach Rückfrage — neu starten geht nur am Rechner selbst

Live führt Stop und den Transportknopf erst am nächsten Taktstrich aus. Bis dahin pulsiert die getippte Stelle hell mit „WARTET".

📱 Auf iPhone und iPad blendet der Vollbild-Button Safaris Adressleiste nie zuverlässig aus — eine Einschränkung des Browsers, kein Fehler dieser Seite. So klappt es garantiert:

1. Diese Seite ganz normal in Safari öffnen (nicht im „Vollbild"-Zustand).
2. Unten das Teilen-Symbol antippen.
3. Im Menü nach unten scrollen bis „Zum Home-Bildschirm" — getrennt von „Zu Lesezeichen hinzufügen". Nur Ersteres startet ohne Adressleiste.
4. Oben rechts „Hinzufügen" antippen.
5. Safari verlassen, auf dem echten Home-Bildschirm das neue Symbol suchen und darauf tippen.

Transport-Leiste oben

Vier Tasten neben Tempo und Takt steuern Lives Transport, unabhängig von den Loopern:

Play/Stop starten und stoppen Lives Transport, Rec und Loop schalten die Arrangement-Aufnahme bzw. den Arrangement-Loop um — sofort über die Live-API, ohne Einrichtung.

Zusätzliche Controller

Hardware (optional)

Beide Geräte lösen dieselben Zuweisungen aus wie die Bedienung im Browser und dürfen gleichzeitig laufen.

KORG nanoKONTROL2optional▶

Bedienoberfläche LooperDisplay (Schritt 2) mit Eingang nanoKONTROL2 (SLIDER/KNOB) und Ausgang nanoKONTROL2 (CTRL) statt „Kein". Das KORG bietet zudem die Möglichkeit, alle Looper gleichzeitig zu starten und zu stoppen, sowie die Lautstärke-Fader in Ableton pro Looper zu bedienen.

• Auslieferungszustandder Controller muss auf den Werks-CCs senden (z. B. S = CC 32–39) — nach eigenen Scenes im KORG KONTROL Editor einmal zurücksetzen
• LED Mode = Externalim KORG KONTROL Editor setzen und per „Communication → Write Scene Data" in den Controller schreiben, sonst bleiben die LEDs dunkel

Auf dem Mac sind die „Communication"-Menüpunkte im KORG KONTROL Editor oft nicht anklickbar (getestet mit macOS 26 auf Apple Silicon). Abhilfe: die Einstellung einmalig auf einem Windows-Rechner schreiben — danach steckt sie dauerhaft im Controller.

Welche Taste welche CC sendet

Die Zuweisung hängt an der MIDI-Nachricht, nicht am Gerät: Drückst du R1, S1 oder M1, sendet das dieselben CCs, die du in der Installation per Browser-Tap zugewiesen hast — die Mappings aus der Installation greifen also automatisch auch am Pult.

Taste	CC	Ziel im Looper
R 1–8	64–71	der große Transportknopf
S 1–8	32–39	Stop
M 1–8	48–55	Clear

⚠️ R1, S1 und M1 gehören fest zu Looper 1: Lives Mapping folgt den Bank-Tasten des Pults nicht, nur die Fader tun das.

Ein Kanalzug bedient jeweils einen Looper — Fader, S/M/R und die Transportleiste ganz rechts.

Die LEDs am nanoKONTROL2

Pro Looper-Streifen zeigen drei übereinanderliegende LEDs — S, M, R —, welche Taste gerade sinnvoll ist, genau wie am Gerät selbst. Die Vorschau unten zeigt automatisch alle fünf Zustände.

S

M

R

–

Roland SPD-SX PROoptional▶

Zweites Remote Script, Ordner Zum Kopieren/Remote Scripts/SPD_SX_Pro_Looper ebenfalls nach ~/Music/Ableton/User Library/Remote Scripts/ kopieren. In einer weiteren freien Zeile der Bedienoberflächen:

Bedienoberfläche	Eingang	Ausgang
SPD_SX_Pro_Looper	SPD-SX PRO	IAC-Treiber Bus 1

Der Ausgang geht nicht an das SPD, sondern in dieselbe IAC-Schleife wie beim nanoKONTROL2. Am Gerät müssen neun Pads auf feste Noten (Kanal 1) programmiert sein.

Neun Pads im 3×3-Raster — Belegung wie in der Übersicht weiter unten.

Fertiges Preset statt von Hand programmieren

Im Ordner Zum Kopieren/SPD-SX Pro Preset liegt die Kit-Datei KIT-APP_LooperDisplay.TD0 — sie enthält alle neun Pad-Zuweisungen fertig eingerichtet.

1. SPD-SX PRO per USB verbinden, SPD-SX PRO APP öffnen (kostenlos von Roland, verbindet automatisch mit dem Gerät).
2. Menü BACKUP → LOAD 1 KIT.
3. Im Dialog „BACKUP LOAD 1 KIT (FROM FILE)" über … die Datei KIT-APP_LooperDisplay.TD0 auswählen, OK.
4. Oben rechts auf WRITE klicken — schreibt den geladenen Kit auf das Gerät.

Pad-Übersicht

Die drei linken Pads wirken immer auf den gerade am Gerät gewählten Looper — welcher das ist, zeigt die Anzeige mit einem gelben Rahmen:

SPD

Gelber Rahmen um den Ring, mit diesem Schild rechts oben — genau wie in der Anzeige selbst.

links obenClearNote 1

Mitte obenalle Looper startenNote 4

rechts obenTransport Start/StopNote 62

links MitteStopNote 2

Mittealle Looper stoppenNote 5

rechts MitteLoop-ToggleNote 65

links untenStart / Rec / OverdubNote 3

Mitte unten◀ vorheriger LooperNote 6

rechts untennächster Looper ▶Note 68

vom Script ausgewertet von AbleSet

Maßgeblich sind die Notennummern, nicht die Position. Die Auswahl läuft nicht im Kreis, sondern stößt an den Enden an. Alle Pads liegen auf MIDI-Kanal 1.

Für Fortgeschrittene

Ableton-Einstellungen im Detail

Damit beide Scripts und die Anzeige laufen, müssen in Einstellungen → Link, Tempo & MIDI die passenden Bedienoberflächen aktiv sein — mit beiden Controllern zusammen:

In der MIDI-Ports-Tabelle darunter müssen drei Zeilen stimmen:

Remote ist Voraussetzung für die Clear-Zuweisungen. Beim IAC-Eingang muss Track aus bleiben, sonst landen die Clear-CCs zusätzlich in scharfgeschalteten MIDI-Spuren.

Bevor du fragst

Grenzen

• Status Looper leerverrät die Live-API nicht — die Anzeige weiß es nur aus eigener Messung oder einem Klick. Nach einem Sammelstart über Hardware (alle Looper gleichzeitig, unquantisiert über den State-Parameter) stehen auch leere Looper auf „Play" und sind vorübergehend nicht von gefüllten zu unterscheiden
• NetzwerkApp und Live müssen im selben Netz laufen, sie hört per UDP mit — das geht nicht über das Internet
• Architekturgetestet auf Apple-Silicon-Macs; für Intel-Macs oder Windows bitte melden

Kleingedrucktes

Lizenz

Dieses Projekt ist für den persönlichen, nicht-kommerziellen Gebrauch gedacht. Weitergabe an Freunde und Bandkollegen ist ausdrücklich erwünscht — Weiterverkauf oder Veröffentlichung als eigenes Produkt bitte nicht ohne Rücksprache.

Selbst gebaut mit Node.js, unter Verwendung der Pakete ws und @julusian/midi (beide MIT-Lizenz).

First-time setup

Installation

The app is a ready-built program for Apple Silicon Macs (M-series chips). No Node.js, no npm install, no terminal knowledge required.

What you get

The Programm (nicht anfassen) folder needs to stay exactly as it is — the node_modules inside it holds the MIDI link used to control individual loopers from the browser.

1 Copy the Remote Script

Copy the folder Zum Kopieren/Remote Scripts/LooperDisplay to

~/Music/Ableton/User Library/Remote Scripts/

If you also own a Roland SPD-SX PRO, copy the Zum Kopieren/Remote Scripts/SPD_SX_Pro_Looper folder there as well.

2 Set up Ableton Live

1. Start Live (or restart it if it was already open — Remote Scripts are only read in at program start).
2. Open Settings → Link, Tempo & MIDI.
3. Select LooperDisplay in an empty Control Surface row.

✅ Without your own hardware, Input and Output stay set to „None" — a KORG nanoKONTROL2 is optional. Even without one connected, the script still feeds all the data the display needs.

3 Start the app

Switch to this folder in Finder and double-click Looper-Display starten.command there.

1. The very first time, macOS blocks it with „cannot be opened because the developer cannot be verified". That's normal for a self-built program without an expensive Apple certificate.
2. In Finder, right-click the file → „Open" → confirm „Open" again in the dialog. That's needed only once; after that, a normal double-click works.
3. A Terminal window briefly appears, then minimizes itself, and a browser tab with the display opens automatically.

The very first time, macOS also asks once whether „osascript" may control Terminal — needed to minimize the window and later close it again. Please allow it. Without that permission the app still runs fine, the window just stays open.

For a tablet, additionally open the second address shown in the (minimized) Terminal window there in Safari:

Anzeige: http://localhost:8080
         http://192.168.0.XXX:8080  (for tablet/phone)

4 Set up on a tablet (optional)

For a display with no browser interface at all: open the second address in Safari, then Share icon → „Add to Home Screen" — not „Add Bookmark". The page then launches from its own icon with no address bar whatsoever.

How do you stop it again?

In Finder, double-click Looper-Display beenden.command — it finds and stops the app even if the (minimized) Terminal window is long out of sight. Two more, equally good ways: ⏻ Server beenden in the top right of the display itself, or Ctrl + C in the (restored) Terminal window.

Closing just the browser tab showing the display leaves the app running in the background — usually what you want if a tablet is meant to keep the page open permanently.

Once it's running

Using it

The rings

Each looper has two rings: the outer one shows progress across the whole loop length with one mark per bar, the inner one is a pie that fills up once per bar. The centre shows bar / total bars and the state.

Controls in the browser

• Tap the inner circlethe looper's transport button — Record, Play or Overdub, depending on state
• Tap twice, quicklystops the looper — Ableton itself treats two quick clicks as a "double-click to stop"
• Press and hold (0.6 s)cycle the bar count by hand (1, 2, 4, 8, 16) when the length is unknown
• Corner button STOPbottom left of the ring — the same stop, as its own button
• Corner button CLEARbottom right of the ring — clears the looper
• Key F / "Fullscreen" buttontoggle fullscreen
• Key Rre-scan for loopers in the set, after a rebuild
• "⏻ Server beenden" (Stop server)stops the Node server, after confirming — starting it again only works at the computer itself

Live only executes Stop and the transport button on the next bar line. Until then, the tapped spot pulses brightly with „WAITING".

📱 On iPhone and iPad, the Fullscreen button can never reliably hide Safari's address bar — that's a limitation of the browser, not a bug in this page. Here's what's guaranteed to work:

1. Open this page normally in Safari (not in the "Fullscreen" state).
2. Tap the Share icon at the bottom.
3. Scroll down in the menu until you see „Add to Home Screen" — separate from „Add Bookmark". Only the former launches without an address bar.
4. Tap „Add" in the top right.
5. Leave Safari, find the new icon on your actual home screen, and tap that.

Transport bar at the top

Four buttons next to the tempo and bar counter control Live's transport, independently of the loopers:

Play/Stop start and stop Live's transport, Rec and Loop toggle arrangement recording and the arrangement loop — instantly through the Live API, no setup required.

Extra controllers

Hardware (optional)

Both devices trigger the same mappings as browser control and can run at the same time.

KORG nanoKONTROL2optional▶

Control Surface LooperDisplay (step 2) with Input nanoKONTROL2 (SLIDER/KNOB) and Output nanoKONTROL2 (CTRL) instead of „None". The KORG also lets you start and stop all loopers at once, and control each looper's volume fader in Ableton.

• Factory statethe controller must send on the factory CCs (e.g. S = CC 32–39) — reset it once in the KORG KONTROL Editor if you've saved custom scenes
• LED Mode = Externalset in the KORG KONTROL Editor and written to the controller via „Communication → Write Scene Data", otherwise the LEDs stay dark

On the Mac, the „Communication" menu items in the KORG KONTROL Editor are often not clickable (tested on macOS 26 on Apple Silicon). Workaround: write the setting once on a Windows machine — after that it stays in the controller for good.

Which button sends which CC

The mapping is tied to the MIDI message, not the device: pressing R1, S1 or M1 sends the same CCs you already mapped by tapping in the browser during installation — those mappings work at the console automatically, too.

Button	CC	Target on the looper
R 1–8	64–71	the big transport knob
S 1–8	32–39	Stop
M 1–8	48–55	Clear

⚠️ R1, S1 and M1 are fixed to looper 1: Live's mapping doesn't follow the controller's bank buttons, only the faders do.

Each channel strip controls one looper — fader, S/M/R, and the transport row on the far right.

The nanoKONTROL2 LEDs

Each looper strip has three stacked LEDs — S, M, R — showing which button currently makes sense, just like on the device itself. The preview below cycles automatically through all five states.

S

M

R

–

Roland SPD-SX PROoptional▶

Second Remote Script — copy the folder Zum Kopieren/Remote Scripts/SPD_SX_Pro_Looper to ~/Music/Ableton/User Library/Remote Scripts/ as well. In another free Control Surface row:

Control Surface	Input	Output
SPD_SX_Pro_Looper	SPD-SX PRO	IAC-Treiber Bus 1

The output doesn't go to the SPD itself, but into the same IAC loop as the nanoKONTROL2. On the device, nine pads need to be programmed to fixed notes (channel 1).

Nine pads in a 3×3 grid — layout as in the overview below.

Ready-made preset instead of programming by hand

The folder Zum Kopieren/SPD-SX Pro Preset contains the kit file KIT-APP_LooperDisplay.TD0 — it has all nine pad assignments already set up.

1. Connect the SPD-SX PRO via USB, open the SPD-SX PRO APP (free from Roland, connects to the device automatically).
2. Menu BACKUP → LOAD 1 KIT.
3. In the „BACKUP LOAD 1 KIT (FROM FILE)" dialog, use … to pick the file KIT-APP_LooperDisplay.TD0, then OK.
4. Click WRITE in the top right — writes the loaded kit to the device.

Pad overview

The three left pads always act on whichever looper is currently selected on the device — this display shows which one with a yellow ring:

SPD

A yellow ring around the looper, with this badge top right — exactly as in the display itself.

top leftClearNote 1

top middlestart all loopersNote 4

top rightTransport start/stopNote 62

middle leftStopNote 2

middlestop all loopersNote 5

middle rightLoop toggleNote 65

bottom leftStart / Rec / OverdubNote 3

bottom middle◀ previous looperNote 6

bottom rightnext looper ▶Note 68

handled by the script handled by AbleSet

The note numbers are what matters, not the position. Selection doesn't wrap around — it stops at both ends. All pads sit on MIDI channel 1.

Advanced

Ableton details

For both scripts and the display to work together with both controllers, these need to be active under Settings → Link, Tempo & MIDI:

In the MIDI Ports table below, three rows need to be set correctly:

Remote is required for the Clear mappings to fire. On the IAC input, Track must stay off, otherwise the Clear CCs would also land on any armed MIDI tracks.

Before you ask

Limitations

• Looper-empty statusthe Live API doesn't reveal this — the display only knows it from its own measurement or a manual click. After a hardware group start (all loopers at once, unquantised via the State parameter), empty loopers also show as „Play" and are briefly indistinguishable from full ones
• Networkthe app and Live must be on the same network, it listens over UDP — this doesn't work over the internet
• Architecturetested on Apple Silicon Macs; for Intel Macs or Windows, please get in touch

Fine print

License

This project is meant for personal, non-commercial use. Sharing it with friends and bandmates is explicitly encouraged — please don't resell it or publish it as your own product without asking first.

Built with Node.js, using the packages ws and @julusian/midi (both MIT licensed).