Skripte (Lua) und Kommandozeile

Skript-Manager

Skripte → Skript-Manager … öffnet das Verwaltungsfenster: links die Skripte des Songs mit Importieren … (eine .lua-Datei in den Skriptordner kopieren), Ordner öffnen (Skriptordner im Explorer), + Neu, Beispielskript und Werkzeug-Skripte; Doppelklick führt ein Skript aus. Rechts steht der Editor des markierten Skripts mit Farben für den Lua-Code (Schlüsselwörter, Zeichenketten, Zahlen, Kommentare, daw-Aufrufe); Speichern (Strg+S), Ausführen (speichert zuerst), Verwerfen, Umbenennen und Löschen (mit Rückfrage). Das Beispielskript legt keine Spuren mehr an, es listet nur die Spuren und ihre Clips.

Lua-Skripte

Skripte liegen im Song unter script/*.lua (ältere Songs: scripts/) und erscheinen im Menü Skripte. Beispielskript anlegen erzeugt scripts/beispiel.lua. Ein Skript liest eine Kopie der Sitzung und liefert Befehle; das Ergebnis ist ein Rückgängig-Schritt. Bei einem Fehler (Syntax, Laufzeit, Zeit, Speicher, ungültiger Befehl) bleibt das Projekt unverändert.

Befehle und Abfragen (daw.…)

Die genaue Liste steht in crates/rdaw-script/src/lib.rs; neue Aufrufe kommen dort hinzu.

-- Beispiel: Spur anlegen und Spuren mit ihrer Clipzahl auflisten
local id = daw.add_track("Klick")
for i, t in ipairs(daw.tracks()) do
  daw.log(t.name, #daw.clips(t.id))
end
daw.add_marker("Refrain", daw.seconds(32))

Werkzeuge: Noten bearbeiten, Auswahl, Parameter

Skripte können MIDI-Noten lesen und schreiben, sehen die Auswahl und fragen vor dem Lauf Werte in einem Dialog ab. Damit entstehen eigene Werkzeuge, die du mit Rechtsklick auf einen MIDI-Clip aufrufst. Alles bleibt ein Rückgängig-Schritt (Befehle und neue MIDI-Inhalte zusammen); bei einem Fehler ändert sich nichts.

Skripte → Werkzeug-Skripte anlegen legt sieben fertige Werkzeuge im Skriptordner an (vorhandene Dateien bleiben unberührt): Humanize (Anfang und Anschlag zufällig streuen, mit festem Zufallswert wiederholbar), Skala erzwingen (jede Note auf den nächsten Ton einer Skala: Dur, Moll, Pentatoniken, Dorisch, Blues) Arpeggio (Akkorde in Einzeltöne zerlegen: aufwärts, abwärts, auf und ab), Strumming (Akkorde wie ein Gitarrenanschlag staffeln, Abstand in ms, Richtung), Euklidischer Rhythmus (Treffer gleichmäßig auf Schritte verteilen, ersetzt den Inhalt des Clips) und Oktaven dazu (jede Note darüber und/oder darunter verdoppeln, leiser). Spuren nummerieren gehört zu den Spur-Werkzeugen (Rechtsklick auf eine Spur, --@menu track). Sie erscheinen danach im Menü Skripte und im Rechtsklickmenü eines Clips unter Werkzeuge; sie wirken auf die gewählten Clips (mehrere mit Strg/Umschalt wählen).

Kopfzeilen eines Skripts

Die Kopfzeilen stehen in den ersten 40 Zeilen; fehlerhafte Zeilen werden übersprungen. Hat ein Skript Parameter, öffnet sich vor dem Lauf der Dialog (Enter = Ausführen, Esc = Abbrechen).

Zusätzliche Aufrufe

--@name Oktave runter
--@menu clip
--@param okt|Oktaven|1|1|3
for _, id in ipairs(daw.selection().clips) do
  local notes = daw.notes(id)
  if notes then
    for _, n in ipairs(notes) do n.key = math.max(0, n.key - 12 * params.okt) end
    daw.set_notes(id, notes)
  end
end

KI-Werkzeug: Skripte von der KI schreiben lassen

Mit KI → KI-Werkzeug (Skript) … (oder im Rechtsklickmenü eines Clips unter Werkzeuge → KI-Werkzeug …) beschreibst du in Worten, was ein Werkzeug tun soll, zum Beispiel „Strumming: Akkorde von unten nach oben anschlagen, 25 ms Versatz pro Ton, einstellbar“. Die KI schreibt daraus ein Lua-Skript mit Kopfzeilen und Reglern. Du brauchst dafür einen API-Schlüssel (KI → KI-Dienste, wie bei der KI-MIDI-Idee).

1. Probelauf: Der Code wird sofort auf einer Kopie des Songs mit deiner aktuellen Auswahl ausprobiert. Scheitert er, geht die Fehlermeldung einmal an die KI zurück (automatische Korrektur). Bleibt es fehlerhaft, steht eine Warnung im Fenster.
2. Prüfen: Der erzeugte Code steht im Fenster und ist bearbeitbar.
3. Speichern legt ihn im Skriptordner des Songs ab (nie überschreibend: bei gleichem Namen wird gezählt); Speichern und ausführen startet ihn gleich, mit dem Parameterdialog. Danach erscheint er im Menü Skripte und im Clipmenü. Ein Lauf ist ein Rückgängig-Schritt.

rdaw-cli – die Kommandozeile

rdaw-cli.exe liegt neben rdaw-app.exe und arbeitet ohne Oberfläche an Projektordnern: zum Prüfen, für Stapelarbeit, für Tests und zum Retten beschädigter Projekte. rdaw-cli --version zeigt die Version. Der Projektordner ist der Songordner (mit der .rdaw-Datei). Positionen und Längen sind in Samples bei 44,1 kHz (44100 = 1 Sekunde). Fehler stehen auf der Fehlerausgabe, der Rückgabewert ist dann 2.

Projekt anlegen und ansehen

Spuren, Clips und Medien

Mixer, Weiterleitung, Tempo und globale Spuren

Rechnen und Exportieren

Geräte und Plugins (nur Windows)

Beispiele

rdaw-cli new C:\Songs\Test
rdaw-cli track C:\Songs\Test Gitarre
rdaw-cli import C:\Songs\Test 1 gitarre.wav 0
rdaw-cli render C:\Songs\Test mix.wav
rdaw-cli dawproject C:\Songs\Test test.dawproject
rdaw-cli salvage C:\Songs\Kaputt C:\Songs\Gerettet