Motion Map Setup

Niveau: Einsteiger | Zielgruppe: Komponist:in, Sound Designer:in, Spatial-Audio-Techniker:in.

Diese Seite erklärt alles, was vor der Nutzung des Motion Map GUIs installiert werden muss: Lua-Scripts in REAPER laden und — für die Live-OSC-Vorschau — Python 3 einrichten. Es müssen keine zusätzlichen Python-Pakete installiert werden.

Was du brauchst

1. Bundle herunterladen

Das ICST Ambi Motion Map Bundle herunterladen und entpacken. Das Bundle enthält zwei Lua-Dateien:

JS_AmbiEncoder64_Motion_Map_GUI.lua          ← diese in REAPER laden
JS_Write_AmbiEncoder64_Spat_Motion_Automation.lua  ← im selben Ordner lassen

Beide Dateien an einen dauerhaften Ort kopieren — zum Beispiel den REAPER-Scripts-Ordner:

• macOS: ~/Library/Application Support/REAPER/Scripts/
• Windows: %APPDATA%\REAPER\Scripts\

2. Script in REAPER laden

1. REAPER öffnen.

2. Actions → Load ReaScript… aufrufen.

3. Zum Ordner mit dem Bundle navigieren.

4. JS_AmbiEncoder64_Motion_Map_GUI.lua auswählen und Open klicken.

   Nur das GUI-Script wird geladen — der Writer wird automatisch aufgerufen.

5. REAPER bestätigt: “Script loaded successfully.”

3. Script zum ersten Mal starten

1. In REAPER einen Track auswählen, der ICST AmbiEncoder_64 als FX enthält.
2. Eine Time Selection (Loop-Range) in der Timeline setzen.
3. Actions → Show action list… öffnen (oder ? drücken).
4. Nach JS_AmbiEncoder64_Motion_Map_GUI suchen.
5. Run klicken — das Motion Map Fenster öffnet sich.

4. Tastaturkürzel zuweisen (empfohlen)

Im Actions-Fenster:

1. JS_AmbiEncoder64_Motion_Map_GUI in der Liste suchen.
2. Neben dem Shortcut-Feld auf Add… klicken.
3. Gewünschte Tastenkombination drücken (z.B. Ctrl+Shift+M).
4. OK klicken.

Ab jetzt öffnet dieser Kürzel das GUI sofort.

5. Python für die Live-OSC-Vorschau einrichten

Die Live-OSC-Vorschau sendet Positionsdaten in Echtzeit an den AmbiEncoder, damit Bewegungen gehört werden können, bevor sie als Automation festgeschrieben werden. Der Python-Helfer verwendet ausschliesslich die eingebauten Module socket und struct — kein pip install notwendig.

Prüfen, ob Python 3 bereits installiert ist

Ein Terminal öffnen (macOS: Terminal.app / Windows: Eingabeaufforderung oder PowerShell) und ausführen:

python3 --version

Bei einer Ausgabe wie Python 3.11.4 ist alles bereit. Weiter zu Schritt 6.

macOS — Python 3 installieren

Option A — Xcode Command Line Tools (einfachste Methode):

xcode-select --install

Den Anweisungen auf dem Bildschirm folgen. Danach ist python3 unter /usr/bin/python3 verfügbar.

Option B — Homebrew (empfohlen, wenn Homebrew bereits installiert ist):

brew install python

Anschliessend prüfen:

python3 --version

Windows — Python 3 installieren

1. Auf python.org/downloads gehen.
2. Den aktuellen Python 3.x-Installer herunterladen.
3. Installer starten. Wichtig: „Add Python to PATH" anhaken, bevor auf Install geklickt wird.
4. Nach der Installation eine neue Eingabeaufforderung öffnen und prüfen:

python3 --version

Falls das nicht klappt, python --version versuchen — auf manchen Windows-Systemen heisst der Befehl python statt python3. Das GUI probiert beide Varianten automatisch.

6. OSC in REAPER einrichten

Die OSC-Vorschau sendet UDP-Pakete an REAPERs eingebauten OSC-Listener, auf den der AmbiEncoder_64 reagiert.

1. In REAPER: Preferences → Control/OSC/web (oder Options → Preferences → Control/OSC/web).
2. Im Bereich Control surface / OSC / web auf Add klicken.
3. Als Modus OSC (Open Sound Control) wählen.
4. Einen Local listen port festlegen — z.B. 9001.
5. Allow binding… aktiviert lassen.
6. OK klicken und Preferences schliessen.

Zurück im Motion Map GUI:

• Host auf 127.0.0.1 setzen
• Port auf 9001 setzen (muss mit dem oben eingestellten Port übereinstimmen)
• Connect klicken

Der Status-Punkt wird grün, sobald der Python-Helfer erfolgreich gestartet ist.

7. Gesamtsetup testen

1. Das Motion Map GUI öffnen.
2. Source S0 aktivieren und als Form Circle zuweisen.
3. Im OSC-Preview-Bereich Connect klicken — Status-Punkt wird grün.
4. Live Preview aktivieren.

Im AmbiEncoder_64-Plugin-Fenster ist nun eine kreisende Bewegung zu sehen. Wenn das funktioniert, sind sowohl die Lua-Scripts als auch die Python-OSC-Verbindung korrekt eingerichtet.

Fehlerbehebung

„Writer not found" beim Klick auf Write

Die beiden Lua-Dateien befinden sich nicht im selben Ordner. JS_Write_AmbiEncoder64_Spat_Motion_Automation.lua in denselben Ordner wie JS_AmbiEncoder64_Motion_Map_GUI.lua verschieben und das GUI neu laden.

OSC Connect — Status-Punkt bleibt rot

Diese Punkte der Reihe nach prüfen:

1. Python 3 installiert? Im Terminal python3 --version ausführen.
2. Port stimmt überein? REAPER-OSC-Lauschport muss gleich dem Port-Feld im GUI sein.
3. REAPER OSC aktiviert? Preferences → Control/OSC/web — Eintrag vorhanden und nicht deaktiviert?
4. Firewall? Auf Windows kann beim ersten Start ein Firewall-Dialog erscheinen. UDP-Zugriff erlauben.
5. Neustart: Disconnect, dann erneut Connect klicken.

macOS — python3 nach xcode-select nicht gefunden

Ausführen:

sudo xcode-select --reset
python3 --version

Windows — python3 nicht erkannt

Das GUI versucht automatisch python als Fallback. Falls beides scheitert, Python von python.org neu installieren und „Add to PATH" aktivieren.

Nächste Schritte

Nach abgeschlossenem Setup:

• Motion Map Benutzerhandbuch — vollständige Anleitung zu allen Funktionen
• ICST Ambi Motion Markers — cue-basierte Alternative für räumliche Bewegung