ICST Ambisonics Plugins · Motion Markers

Motion MarkersBewegung mit REAPER-Markern steuern

Setze Positionen als benannte Marker auf die Timeline, höre die Bewegung dazwischen per OSC vor und nimm sie als AmbiEncoder-Automation auf — im Takt der Musik.

Fortgeschrittene · Komponist:in · Sound Designer:in · Spatial-Audio-Techniker:in

Animation: Ein Punkt wandert im AmbiEncoder-Radar von Marker S nach Marker E, der Cursor läuft auf der REAPER-Timeline mit
Zwei Marker · eine Kurve · Bewegung per OSC · Automation

Über Motion Markers

Motion Markers verbindet REAPER-Marker mit dem ICST AmbiEncoder: Statt Automationskurven von Hand zu zeichnen, definierst du Positionen als Marker und lässt das Skript den Weg dazwischen berechnen.

Marker als Cues

Positionen als benannte Marker setzen oder aus einer CSV-Liste importieren.

Vorhören per OSC

Bewegung zwischen zwei Markern live an den AmbiEncoder senden.

Als Automation aufnehmen

Einzelne Paare oder ganze Serien auf die AmbiEncoder-Spur schreiben.

In diesem Bereich


Wann Markers, wann Motion Map?

  • Markers – du denkst in Cues: Positionen sind benannte Timeline-Marker (musikalisches Timing, Probenmarken, CSV-Cue-Listen), die Bewegung läuft von einem Marker zum nächsten.
  • Motion Map – du denkst in Formen: du zeichnest Pfade oder erzeugst Figuren (Kreis, Spirale, Lissajous) im Figure-Editor, mit Tempo-Sync, und schreibst sie als Automation.

Beide schreiben normale AmbiEncoder-Automation und lassen sich kombinieren. Im vorkonfigurierten ICST-Ambi-Reaper-Ordner hat Markers einen eigenen Toolbar-Button (Scripts in Scripts/ICST/Markers).

Was es macht

ICST Ambi Motion Markers ist ein REAPER-Workflow auf Basis von Timeline-Markern. Statt Automationskurven von Hand zu zeichnen, definierst du Positionen als benannte Marker auf der Timeline — und hörst die entstehende Bewegung per OSC vor oder nimmst sie als Automation auf.

Marker sind beständig und editierbar wie jeder REAPER-Marker — du kannst sie in einer CSV versionieren, umbenennen, auf der Timeline verschieben und erneut importieren, ohne das Plugin anzufassen. Automationskurven bieten das nicht.

Damit kannst du:

  • Quellenpositionen als Marker-Cues definieren
  • einzelne Paare oder ganze Serien per OSC vorhören
  • denselben Bewegungsverlauf als AmbiEncoder-Automation aufnehmen
  • Cue-Sets per CSV importieren statt Markertexte von Hand zu schreiben

Das zentrale Konzept ist das S/E-Paar: S markiert den Beginn eines Bewegungssegments, E das Ende. Jede Vorschau und jede Aufnahme arbeitet entweder auf einem ausgewählten Paar oder auf einer Serie von Paaren ab S bis zum letzten Marker.

ICST Ambi Motion Marker GUI mit vier geladenen Markern

Voraussetzungen

Vor der Installation sicherstellen, dass vorhanden ist:

  • REAPER (v6 oder neuer empfohlen)
  • ICST AmbiEncoder installiert und funktionsfähig — siehe Installation
  • Python 3.9 oder neuer — python.org/downloads
  • OSC-Input im AmbiEncoder-Plugin aktiviert — siehe OSC

Installation

Video: Installation und erste Bewegung Schritt für Schritt (ca. 75 Sekunden). Die Schritte stehen darunter auch als Text.

1. Scripts in REAPER einbinden

In REAPER: Actions-Menü → Load ReaScript… — dann aus dem Bundle auswählen:

  • scripts/JS_Ambi_Motion_Marker_GUI.lua
  • scripts/JS_Import_Ambi_Markers_From_CSV.lua

REAPER Actions-Menü — Load ReaScript Dialog

2. Python-Worker neben die Lua-Scripts legen

Die GUI startet reaper_marker_ambi_motion.py als Hintergrundprozess. Die Datei muss im gleichen Ordner wie die beiden Lua-Scripts liegen (im Bundle: scripts/). Benötigtes Python-Paket installieren:

python3 -m pip install python-osc

Das Feld Python in der GUI leer lassen: Das Script findet selbst ein Python 3 mit python-osc (Homebrew, pyenv, System). Nur wenn die Erkennung scheitert, den vollständigen Pfad eintragen (which python3 im Terminal):

# macOS / Linux
/usr/local/bin/python3
/Users/yourname/.pyenv/versions/3.11.8/bin/python3

# Windows (Beispiel)
C:\Python311\python.exe

Der Worker startet automatisch beim ersten Button-Klick. Für Record pair / Record series das REAPER-Webinterface aktivieren: Einstellungen → Control/OSC/web → Add → Web browser interface, Port 8080.

Tipp: Im Feld Ambi host muss genau 127.0.0.1 ohne Leerzeichen am Ende stehen. Nach einem Script-Update in REAPER Terminate instances wählen und die GUI neu starten.

Python unter Windows

Nach der Installation von Python über python.org/downloads findet REAPER Python möglicherweise nicht automatisch. Den Installationspfad ermitteln mit diesem Befehl in der Eingabeaufforderung:

python -c "import os, sys; print(os.path.dirname(sys.executable))"

Beispielausgabe: C:\Users\stine\AppData\Local\Python\pythoncore-3.14-64

In REAPER dann Preferences → Plug-ins → ReaScript öffnen und „Force ReaScript to use specific Python .dll…" aktivieren — und auf die python3xx.dll in diesem Ordner zeigen (z. B. python314.dll).

Anschliessend python-osc mit demselben Python installieren:

python -m pip install python-osc

3. ICST-Plugin konfigurieren

AmbiEncoder_64 auf der Zielspur einbinden und OSC-Input aktivieren. Der Port im Plugin muss mit dem GUI-Port übereinstimmen (Standard: 50001).

Installations-Checkliste

Vor dem ersten Test prüfen:

  • Beide Lua-Scripts geladen Sichtbar in Actions → Show action list als JS_Ambi_Motion_Marker_GUI und JS_Import_Ambi_Markers_From_CSV
  • Python-Feld Am besten leer lassen – das Script findet selbst ein Python 3 mit python-osc. Nur bei Fehlern den vollen Pfad eintragen (which python3)
  • python-osc installiert pip3 install python-osc für dasselbe Python-Executable ausführen
  • AmbiEncoder OSC-Input aktiv Plugin → OSC In aktiviert, Port stimmt mit GUI-Einstellung überein (Standard 50001)

Tutorial: Deine erste Bewegung in 10 Schritten

  1. python-osc installieren: python3 -m pip install python-osc.
  2. Beide Lua-Scripts laden (Actions → Show action list → New action → Load ReaScript…). reaper_marker_ambi_motion.py bleibt im selben Ordner.
  3. Spur vorbereiten: AmbiEncoder_64 einfügen, OSC-Eingang aktivieren, Port 50001.
  4. Zwei Marker anlegen: ambi 1 a=-45 e=0 d=0.8 und ambi 1 a=45 e=20 d=0.5 – oder examples/ambi_markers_aed_example.csv importieren.
  5. GUI starten über die Actions-Liste. Läuft sie schon, zuerst Terminate instances wählen.
  6. Felder prüfen: Ambi host 127.0.0.1 (kein Leerzeichen am Ende), Ambi port 50001, Python leer.
  7. Paar wählen: ersten Marker linksklicken (S), zweiten rechtsklicken (E), Set Selection drücken.
  8. Vorhören: Send pair drücken. Die Quelle bewegt sich im AmbiEncoder, es wird nichts aufgenommen.
  9. Aufnehmen: Webinterface in REAPER aktivieren (Einstellungen → Control/OSC/web → Add → Web browser interface, Port 8080), AmbiEncoder-Spur wählen, Record pair drücken.
  10. Serie: S auf den ersten Marker einer Phrase setzen und Send series oder Record series nutzen.

Erste Schritte

Folgendes setzt voraus, dass die Installation abgeschlossen ist und die GUI geöffnet ist (JS_Ambi_Motion_Marker_GUI.lua über das Actions-Menü starten).

S/E-Paare: In der GUI-Markerliste die linke Hälfte einer Zeile klicken → S (Start), rechte Hälfte → E (Ende). Dann Set Selection klicken — damit wird der REAPER-Zeitbereich gesetzt, den die GUI für Vorschau und Aufnahme verwendet.

Markernamen folgen diesem Muster: ambi 1 a=-45 e=0 d=0.8 — Quellindex, dann Azimut / Elevation / Distanz. Die GUI erkennt nur Marker, deren Name mit ambi beginnt. Marker können manuell in REAPER gesetzt oder aus einer CSV importiert werden.

1. Einzelne Bewegung vorhören

  1. Zwei Marker in REAPER setzen — z. B. ambi 1 a=-45 e=0 d=0.8 und ambi 1 a=45 e=0 d=0.8 — oder CSV importieren
  2. In der GUI-Markerliste S auf den ersten Marker, E auf den zweiten setzen
  3. Set Selection, dann Send pair klicken
  4. Die Quelle bewegt sich im AmbiEncoder-Plugin

Was zu sehen sein sollte: Vorschau-Cursor bewegt sich über den Zeitbereich, OSC-Ausgabe erscheint in der Konsole, keine Automation geschrieben.

2. Ganze Serie vorhören

  1. S auf den ersten Marker der Phrase setzen
  2. Send series klicken
  3. Die GUI läuft automatisch durch alle Segmente bis zum letzten Marker

3. Ein Paar als Automation aufnehmen

  1. AmbiEncoder-Spur in REAPER selektieren
  2. S und E setzen
  3. Record pair klicken

Was zu sehen sein sollte: Transport läuft, Plugin bewegt sich, Automation-Lanes erhalten Positionsdaten.

4. Ganze Serie aufnehmen

  1. AmbiEncoder-Spur selektieren
  2. S auf den ersten Marker setzen
  3. Record series klicken

Der Transport läuft die komplette Serie durch und schreibt Automation für jedes Segment.

Marker-Workflow

Koordinatensystem

AmbiEncoder verwendet Kugelkoordinaten — Azimut (a), Elevation (e) und Distanz (d):

ParameterBereichBeschreibung
a Azimut−180 … +180°0° = vorne, −90° = links, +90° = rechts, ±180° = hinten
e Elevation−90 … +90°0° = Horizontalebene, +90° = direkt oben, −90° = direkt unten
d Distanz0.0 … 1.01.0 = Oberfläche der Einheitssphäre; Werte über 1 platzieren die Quelle ausserhalb

Die intern verwendete XYZ-Konversion folgt der ICST-Konvention: X = D·cos(E)·sin(A), Y = D·cos(E)·cos(A), Z = D·sin(E).

Marker-Syntax

Marker werden mit Positionsdaten in dieser Form benannt:

ambi 1 a=-45 e=0 d=0.8
ambi 2 a=20 e=0 d=0.7

1 / 2 = Quellindex, a = Azimut, e = Elevation, d = Distanz.

Mehrere Quellen am selben Cue-Zeitpunkt können in einem Marker kombiniert werden:

ambi 1 a=-45 e=0 d=0.8 | ambi 2 a=20 e=0 d=0.7

S und E setzen

In der GUI-Markerliste repräsentiert jede Zeile einen Marker. Linke Seite einer Zeile klicken → S (Start), rechte Seite → E (Ende). Dann Set Selection klicken, um den REAPER-Zeitbereich zwischen S und E zu erstellen.

S und E definieren zusammen ein Bewegungssegment — von der Quellposition bei S zur Position bei E.

S/E-Selektion aktiv mit Konsolenausgabe

Cues per CSV importieren

Manuelle Marker funktionieren gut für wenige Cues. Wechsle zu CSV, sobald du mehr als sechs oder sieben Positionen hast, wenn Koordinaten aus einer Partitur oder einem Raumplanungs-Spreadsheet stammen, oder wenn du das Cue-Set zusammen mit dem Projekt in git versionieren möchtest. CSV bearbeiten, einmal Load CSV klicken — alle Marker werden aktualisiert, kein erneutes Eintippen.

Format: AED

time,index,source,azimuth,elevation,distance
1.2,1,1,-45,0,0.8
1.2,1,2,20,0,0.7
9.2,2,1,45,20,0.5
9.2,2,2,90,0,0.2

Format: XYZ

time,index,source,x,y,z
1.2,1,1,-0.566,0.566,0.000
1.2,1,2,0.239,0.658,0.000

Import in der GUI

  1. Load CSV im Marker-Panel klicken
  2. CSV-Datei auswählen
  3. Passende Marker im Projekt werden automatisch ersetzt

Import-Ambi-Markers-From-CSV-Dialog

Beispiel-CSV-Dateien sind im Bundle enthalten: ambi_markers_aed_example.csv und ambi_markers_xyz_example.csv.

Hauptfunktionen

Send pair

Sendet das aktuell gewählte S → E-Paar per OSC — die Quelle bewegt sich im Plugin, aber es wird keine Automation geschrieben. Damit lässt sich ein einzelnes Segment vor der Aufnahme testen und verfeinern.

Während der Wiedergabe bewegt sich der REAPER-Edit-Cursor in Echtzeit über den Zeitbereich, und oben rechts erscheint ein PREVIEW-Indikator. Stop preview klicken, um Cursor und OSC-Bewegung gemeinsam zu stoppen.

Send-pair-Workflow mit Konsolenausgabe nach der Bewegung

Send series

Sendet alle Segmente vom aktuellen S-Marker bis zum letzten Marker der Liste, eines nach dem anderen. Für die Vorschau einer kompletten Phrase oder Szene.

Record pair

Nimmt das gewählte S → E-Segment als AmbiEncoder-Automation auf. Die AmbiEncoder-Spur muss vor dem Klick selektiert sein.

Record series

Gleiche Bereichslogik wie Send series, schreibt aber Automation für jedes Segment, während der Bewegungsablauf durchläuft. Der Transport läuft einmal vom ersten bis zum letzten Ambi-Cue durch; der Worker-Status zeigt Segment 1/N, 2/N usw.

Interpolationsmodi

Das Curve-Dropdown bestimmt, wie sich die Quelle zwischen S und E bewegt:

ModusCharakter
LinearGerade Linie im XYZ-Raum — konstante Geschwindigkeit
ParabolSanfter Start und sanftes Ende — quadratisches Easing
ExponSehr sanfter Start, schnelle Mitte, sanftes Ende
PolarBogen im AED-Raum — Azimut/Elevation bewegen sich als Winkel, nicht als XYZ-Linie durch die Sphäre
SmoothstepNeutrale glatte Kurve — aus Kompatibilitätsgründen beibehalten

Polar ist die richtige Wahl, wenn die Quelle einen Bogen beschreiben soll, statt direkt durch das Innere der Sphäre zu schneiden.

Markerlisten-Navigation

  • Linke Hälfte einer Marker-Zeile klicken → als S (Start) setzen
  • Rechte Hälfte klicken → als E (Ende) setzen
  • < Pair / Pair > — gewähltes Paar einen Schritt durch die Marker-Sequenz verschieben (z. B. 1→3 wird zu 2→4)
  • Follow ON — Markerliste scrollt mit dem Abspiel- oder Edit-Cursor mit
  • Der kleine Timeline-Balken unten zeigt Marker-Positionen und aktuellen Cursor-Ort

Next pair after stop

Wenn aktiviert, rückt die GUI nach dem Ende einer Vorschau oder Aufnahme automatisch zum nächsten Paar weiter — 1→3 wird zu 2→4, bereit für den nächsten Trigger. Die nächste Bewegung startet nicht automatisch.

Polyphonic mode

Polyphonic all indexes sendet alle passenden ambi <index>-Paare gleichzeitig, nicht nur das erste gefundene. Wenn Quelle 1 und Quelle 2 jeweils einen Cue bei S und bei E haben, bewegen sich beide gleichzeitig. Quellen, die nur an einem Ende vorkommen, werden übersprungen.

XYZ Score

Der Button XYZ score erstellt oder aktualisiert eine Spur namens Ambi XYZ Score. Für jedes benachbarte Cue-Paar wird ein stummgeschaltetes, leeres Item auf dieser Spur platziert. Die Item-Notizen enthalten die XYZ-Koordinaten jeder Quelle an Start und Ende:

XYZ 01  0.50s -> 16.50s
1: (-0.566, 0.566, 0.000) -> (0.332, 0.332, 0.171)
2: (0.239, 0.658, 0.000) -> (0.200, 0.000, 0.000)

Das ergibt eine lesbare Partitur-Ansicht aller räumlichen Bewegungen, ohne die GUI öffnen zu müssen. Erneutes Klicken auf XYZ score ersetzt nur die GUI-generierten Items; alles andere auf der Spur bleibt unberührt.

Good Practices

  • CSV als Source of Truth für grössere Cue-Sets verwenden — leichter zu bearbeiten und versionieren als manuelle Marker
  • immer zuerst mit Send pair vorhören, bevor aufgenommen wird
  • Marker-Indizes stabil halten — Umnummerieren bricht CSV-Re-Imports
  • eine Quelle pro CSV-Zeile
  • musikalisch klare Cue-Punkte setzen (an Phrasen-Grenzen, nicht mitten in einer Geste)
  • Konsolenausgabe beim Debuggen aktivieren, beim Aufführen deaktivieren

Troubleshooting

„No markers or regions with ‘ambi…’ found"

Die Markerliste ist leer. Marker manuell hinzufügen oder Load CSV ausführen. Jeder Markername muss mit ambi beginnen (Gross-/Kleinschreibung beachten).

Keine Bewegung im Plugin

Prüfen:

  • OSC-Input im AmbiEncoder-Plugin aktiviert
  • Port im Plugin stimmt mit GUI-Port überein (Standard: 50001)
  • S- und E-Positionen sind tatsächlich verschieden — identische Positionen erzeugen keine sichtbare Bewegung

Send series verhält sich wie Send pair

Es gibt nur noch ein Segment zwischen dem aktuellen S-Marker und dem letzten Marker. S auf einen früheren Marker setzen.

Python nicht gefunden / Worker startet nicht

  • bestätigen, dass der Pfad im Python-Feld auf ein gültiges Python-3-Executable zeigt (which python3 auf macOS/Linux)
  • bestätigen, dass python-osc für genau dieses Python installiert ist: dein/python/pfad -m pip install python-osc
  • Konsolenausgabe in der GUI auf den genauen Fehler prüfen

CSV-Import schlägt fehl

Prüfen:

  • Spaltenbezeichnungen stimmen exakt (time, index, source, dann Positionsspalten)
  • Dezimalpunkte (keine Kommas) bei Zahlen
  • eine Quelle pro Zeile
  • gültige Zeitwerte und Indizes

Siehe auch

ICST Ambi Motion Map — algorithmischer Bewegungsgenerator für AmbiEncoder_64. Bewegungsformen (Kreis, Spirale, Lissajous…) pro Source zuweisen und XYZ-Automation mit einem Klick schreiben. Motion Map für generative Raumtexturen; Motion Markers für musikalisch getimte, Cue-basierte Bewegung.