Befehlszeilenschnittstelle

Integrieren Sie OpenShot in Ihren Befehlszeilen-Workflow. Importieren Sie Aufnahmen, schneiden und ordnen Sie Clips an, wenden Sie Effekte an, animieren Sie Eigenschaften mit Keyframes und exportieren Sie Videos direkt aus Ihrem Terminal. Verwenden Sie einige Befehle, um wiederholte Bearbeitungen zu automatisieren, ein Skript für ein wiederkehrendes Projekt zu schreiben oder lassen Sie einen KI-Agenten helfen, ein Video zusammenzustellen und zu verfeinern.

Die Befehlszeile arbeitet mit denselben Projekten wie der Editor. Sie können einen geöffneten Editor steuern und Änderungen sofort überprüfen oder in einer kopflose Sitzung ohne Fenster arbeiten. Eine Sitzung hält Ihr Projekt zwischen Befehlen geöffnet, einschließlich Bearbeitungen, Rückgängig-Verlauf und Exportaufträgen. Speichern Sie es als .osp-Projekt, wann immer Sie später weiter bearbeiten möchten.

Erste Schritte

Verwenden Sie Ihre installierte OpenShot-Ausführungsdatei gefolgt von --cli. Beginnen Sie mit intro für eine kurze Anleitung zu Sitzungen, Bearbeitung, Animation und Speicherung oder mit help für eine Befehlsübersicht. Diese Befehle benötigen keine aktive Sitzung. Die folgenden Beispiele erfordern eine OpenShot-Version mit Befehlszeilenbearbeitung.

Linux AppImage

Aus dem Verzeichnis, das Ihre heruntergeladene AppImage-Datei enthält:

./OpenShot.AppImage --cli intro
./OpenShot.AppImage --cli help

Ersetzen Sie OpenShot.AppImage durch Ihren heruntergeladenen Dateinamen. Wenn AppImageLauncher Desktop-Integrationsdialoge anzeigt, setzen Sie APPIMAGELAUNCHER_DISABLE=1 bevor Sie den Befehl ausführen:

APPIMAGELAUNCHER_DISABLE=1 ./OpenShot.AppImage --cli intro

Für Skripte oder wiederholte Befehle setzen Sie es einmal in Ihrer aktuellen Shell:

export APPIMAGELAUNCHER_DISABLE=1
./OpenShot.AppImage --cli session start

Die Variable muss vor dem Starten der AppImage gesetzt werden: AppImageLauncher kann sie abfangen, bevor OpenShot --cli erhält. Relative Medienpfade und @batch.json-Dateien werden vom Arbeitsverzeichnis aus aufgelöst. Halten Sie die AppImage-Datei verfügbar, solange Sitzungen oder Exporte laufen.

Linux Snap

Für den OpenShot Snap verwenden Sie:

snap run openshot-qt --cli intro
snap run openshot-qt --cli help
snap run openshot-qt --cli session start

Die Dateiberechtigungen von Snap gelten auch für die Befehlszeilenbearbeitung. Bewahren Sie Medien, Projekte und Exporte an Orten auf, auf die Snap zugreifen kann, z. B. in Ihrem Home-Verzeichnis. Um Zugriff auf externe Laufwerke zu erlauben, aktivieren Sie die Berechtigung für Wechseldatenträger:

sudo snap connect openshot-qt:removable-media

Windows

Wichtig

Verwenden Sie openshot-qt-cmd.exe für die Befehlszeilenbearbeitung unter Windows. Diese Konsolenanwendung zeigt Befehlsresultate, Hilfe und Fehler in Ihrem Terminal an. Die Desktop-Anwendung openshot-qt.exe zeigt keine Standardausgabe in einem interaktiven Terminal an, wodurch Befehle ohne sichtbares Feedback bleiben und die CLI schwer zu benutzen ist.

In PowerShell aus dem OpenShot-Installationsverzeichnis:

& .\openshot-qt-cmd.exe --cli intro
& .\openshot-qt-cmd.exe --cli help
& .\openshot-qt-cmd.exe --cli session start

Wenn Sie sich in einem anderen Verzeichnis befinden, verwenden Sie den vollständigen Pfad zu openshot-qt-cmd.exe. Behalten Sie --cli nach dem Programmnamen bei.

macOS

Für eine Installation in Applications:

"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli intro
"/Applications/OpenShot Video Editor.app/Contents/MacOS/openshot-qt" --cli help

Befehle finden

Im gesamten Leitfaden steht openshot-cli als Kurzform für den oben genannten Befehl Ihrer Installation, z. B. snap run openshot-qt --cli oder ./OpenShot.AppImage --cli. Einige Installationen bieten auch direkt einen openshot-cli-Befehl an. Beim Ausführen aus dem Quellcode verwenden Sie python3 src/launch.py --cli in der Python-Umgebung von OpenShot.

Nur --cli, --cli help und --cli --help zeigen dieselbe Übersicht. Die Hilfe wird spezifischer, wenn Sie Befehle durchgehen:

openshot-cli clip help
openshot-cli clip keyframe help
openshot-cli clip keyframe set help
openshot-cli edit help
openshot-cli text help
openshot-cli effects list
openshot-cli effects audiovisualization help
openshot-cli effects audiovisualization help --property background

Gruppenhilfe erklärt Arbeitsabläufe mit Beispielen; Bedienungshilfe beschreibt Argumente und Verhalten. --help entspricht dem nachgestellten help. Alle Hilfebefehle funktionieren ohne Bearbeitungssitzung.

effects list zeigt die verfügbaren Effekte mit kurzen Beschreibungen. Die Effekt-Hilfe erklärt deren Eigenschaften, Standardwerte, Auswahlmöglichkeiten und Bereiche. effects instances listet Effekte auf, die bereits an Clips angehängt sind, mit den IDs der übergeordneten Clips. Klassenname, Anzeigename und Unterstrich-Aliase identifizieren denselben Effekt.

Arbeiten mit Skripten und KI-Agenten

KI-Coding-Agenten wie Codex und Claude Code können die CLI verwenden, um OpenShot-Projekte über Terminalbefehle zu inspizieren und zu bearbeiten. Geben Sie Ihrem Agenten den Pfad zur OpenShot-Ausführungsdatei, die Medien oder das Projekt, mit dem gearbeitet werden soll, und das gewünschte Ergebnis: Dauer, Abmessungen, Animationsstil und Ausgabepfad. Bitten Sie ihn, vor dem Start --cli intro zu lesen. Dieselben Befehle funktionieren, wenn Sie sie selbst eingeben oder aus einem Skript ausführen.

Beginnen Sie mit intro und verwenden Sie dann bei Bedarf befehlsspezifische Hilfe. Ein nützlicher Arbeitsablauf ist, eine Sitzung auszuwählen, das Projekt zu inspizieren, eine kleine Anzahl von Änderungen vorzunehmen, das Ergebnis zu überprüfen und zu speichern. Befehle geben strukturiertes JSON zurück, sodass Skripte und Agenten Objekt-IDs und Ergebnisse direkt verwenden können, anstatt die Bildschirmausgabe zu interpretieren.

  • Vor dem Bearbeiten inspizieren. Verwenden Sie zurückgegebene IDs und Eigenschaftsinformationen, anstatt Namen, Spurennummern oder Zeitpunkte zu erraten. Wählen Sie eine Sitzung explizit aus, wenn mehr als ein Projekt geöffnet ist.

  • Gruppieren Sie wiederholte Bearbeitungen. Verwenden Sie edit apply für eine Folge von Änderungen oder edit bulk, um eine Vorlage auf ausgewählte Clips anzuwenden. Validieren Sie mit --dry-run, bevor Sie einen Batch anwenden.

  • Animation überprüfen. Wählen Sie einen Koordinatenraum, beginnen Sie mit einigen Schlüsselbildern und verwenden Sie Easing-Voreinstellungen für vertraute Bewegungen. keyframe preview nimmt die Kurve auf, damit Sie Pausen oder Sprünge vor dem Export erkennen können. Überprüfen Sie auch die gerenderte Bewegung; ein Kontaktbogen allein kann nicht zeigen, wie sich eine Animation anfühlt.

  • Speichern und Exporte verfolgen. Speichern Sie das Projekt explizit und überprüfen Sie den Status des Exportauftrags, bevor Sie eine Ausgabe als abgeschlossen betrachten. Wenn eine Anfrage abläuft, prüfen Sie den Status, bevor Sie eine Bearbeitung wiederholen.

Die folgenden Abschnitte erklären diese Arbeitsabläufe und ihre Zeitkonventionen.

Sitzungen und Ausgaben

Starten oder Finden einer Sitzung

Starten Sie eine Headless-Sitzung (ohne Editorfenster):

openshot-cli session start

Um ein bestehendes Projekt beim Start zu öffnen, fügen Sie --project "/pfad/projekt.osp" hinzu. Die erfolgreiche JSON-Antwort enthält result.session_id. Kopieren Sie diesen Wert. Wenn OpenShot bereits läuft oder Sie die ID vergessen haben, finden Sie verfügbare Sitzungen mit:

openshot-cli session list

Wählen Sie die Sitzung für das Projekt, das Sie bearbeiten möchten. Sie müssen nicht für jeden Befehl eine neue Sitzung starten.

Auswahl einer Sitzung

Tipp

Setzen Sie OPENSHOT_SESSION einmal und führen Sie dann die Befehle normal aus. Ihr Terminal merkt sich die ausgewählte Sitzung, sodass Sie nicht bei jedem Befehl --session übergeben müssen. Verwenden Sie das untenstehende PowerShell- oder Bash-Beispiel.

Ersetzen Sie unten SESSION_ID durch die von session start oder session list zurückgegebene session_id.

Windows PowerShell:

$env:OPENSHOT_SESSION = "SESSION_ID"
& .\openshot-qt-cmd.exe --cli timeline view
& .\openshot-qt-cmd.exe --cli export start "C:\path\test.mp4" --wait

Linux Bash:

export OPENSHOT_SESSION="SESSION_ID"
./OpenShot.AppImage --cli timeline view
./OpenShot.AppImage --cli export start "/path/test.mp4" --wait

Unter macOS verwenden Sie die gleiche export-Syntax. Für macOS- oder Snap-Befehle ersetzen Sie das ausführbare Programm durch das Ihrer Installation aus dem Abschnitt Erste Schritte. Die Auswahl gilt für dieses Terminal und die daraus gestarteten Befehle. Setzen Sie sie in einem neuen Terminal erneut oder aktualisieren Sie sie beim Wechsel zu einer anderen Sitzung.

Die verbleibenden Bearbeitungs- und Exportbeispiele setzen voraus, dass OPENSHOT_SESSION gesetzt ist. Der nächste Unterabschnitt zeigt, wie die ID automatisch für Skripte erfasst wird.

Um für nur einen Befehl eine andere Sitzung anzusprechen, verwenden Sie --session. Es überschreibt OPENSHOT_SESSION, ohne die Auswahl Ihres Terminals zu ändern:

openshot-cli --session OTHER_SESSION_ID project get

Bei einem verpackten ausführbaren Programm setzen Sie diese Überschreibung nach --cli und vor der Befehlsgruppe: --cli --session ANDERE_SITZUNGS_ID project get.

Die automatische Auswahl funktioniert nur, wenn genau eine erreichbare Sitzung existiert. Wenn Sie session_required sehen, führen Sie session list aus und wählen Sie die gewünschte Sitzung explizit aus. Wenn sie nicht mehr aufgeführt ist, starten Sie sie erneut und verwenden Sie die neue ID. Hilfe, intro und Sitzungsentdeckung erfordern keine ausgewählte Sitzung.

Automatisches Erfassen der Sitzungs-ID

Skripte können result.session_id direkt aus dem von session start zurückgegebenen JSON lesen und OPENSHOT_SESSION für nachfolgende Befehle setzen. Es ist nicht nötig, die ID manuell zu kopieren oder eine Protokolldatei zu lesen. Überprüfen Sie, ob der Start erfolgreich war, bevor Sie die zurückgegebene ID verwenden.

Windows PowerShell (setzen Sie den Pfad zur ausführbaren Datei Ihrer Installation):

$openshot = "C:\Program Files\OpenShot Video Editor\openshot-qt-cmd.exe"
$reply = & $openshot --cli session start
if ($LASTEXITCODE -ne 0) { throw "OpenShot session startup failed" }
$session = $reply | ConvertFrom-Json
if (-not $session.ok -or -not $session.result.session_id) {
    throw "OpenShot did not return a session ID"
}
$env:OPENSHOT_SESSION = $session.result.session_id
& $openshot --cli timeline view

Linux Bash (benötigt jq zum Lesen von JSON):

openshot="/full/path/to/OpenShot.AppImage"
export APPIMAGELAUNCHER_DISABLE=1
if reply=$("$openshot" --cli session start) &&
   session_id=$(printf '%s' "$reply" | jq -er 'select(.ok == true) | .result.session_id | strings | select(length > 0)'); then
    export OPENSHOT_SESSION="$session_id"
    "$openshot" --cli timeline view
else
    echo "OpenShot session startup failed" >&2
fi

Die Umgebungsvariable wählt eine Sitzung für Befehle aus, die von diesem Terminal gestartet werden; sie ändert keine systemweite Einstellung. Das Starten einer Sitzung setzt die Variable nicht automatisch. Nach dem Beenden der Sitzung löschen Sie die Auswahl mit Remove-Item Env:OPENSHOT_SESSION in PowerShell oder unset OPENSHOT_SESSION in Bash.

Anzeigen und Beenden einer Sitzung

Um die ausgewählte Sitzung im Editor anzuzeigen:

openshot-cli session show

Auf einem Desktop erstellt session show den Editor im selben Prozess und behält das laufende Projekt, IDs, Verlauf, Exportaufträge und die Verbindung bei. Wiederholte Aufrufe bringen das bestehende Fenster in den Vordergrund. session start --show öffnet es sofort. Sitzungen, die ohne Anzeige oder mit QT_QPA_PLATFORM=offscreen/minimal gestartet wurden, können später kein Desktopfenster anzeigen. Für diese Sitzungen speichern Sie das Projekt und öffnen es in einer neuen Desktop-Sitzung. Nach dem Anzeigen schließen Sie die Sitzung über das Editorfenster.

Globale Optionen (--session, --timeout) stehen vor dem Befehl. session serve bleibt im Vordergrund für Supervisoren; session start kehrt zurück, nachdem ein Hintergrundhost registriert wurde. session stop lehnt ungespeicherte Änderungen und aktive Exporte ab. Verwenden Sie --discard nur, um ungespeicherte Änderungen absichtlich zu verwerfen.

Befehlsausgabe

Ergebnisse sind JSON auf stdout, außer der Standard-Text-Timeline-Ansicht. Fehler sind JSON auf stderr mit Exit-Status 1; Argumentparser-Fehler mit Exit 2. Mutationen liefern kompakte Zusammenfassungen mit einem inspect-Befehl. get gibt natives Objekt-JSON zurück. Projektantworten enthalten eine Revision; Effektkatalog-Antworten benötigen keine Sitzung. Protokolle von Headless-Sitzungen liegen neben ihren Registrierungsdatensätzen. OPENSHOT_SESSION_DIR überschreibt das Standardverzeichnis ~/.openshot_qt/sessions.

Sitzungen akzeptieren Befehle lokal auf Ihrem Computer. Halten Sie das Sitzungsregister privat, da es die Zugangsdaten enthält, die zum Zugriff auf Ihre Bearbeitungssitzungen verwendet werden. Exporte arbeiten mit einem Schnappschuss, sodass Sie während eines laufenden Jobs weiter bearbeiten können.

Projekte öffnen und speichern

Ein OpenShot-Projekt (.osp) speichert Ihre bearbeitbare Zeitleiste. Das Exportieren erstellt ein fertiges Video; das Speichern des Projekts ermöglicht es Ihnen, später zu seinen Clips, Effekten und Keyframes zurückzukehren. Speichern Sie Ihr Projekt separat, auch wenn Sie ein Video exportieren.

Ein Projekt öffnen

Starten Sie eine Sitzung mit einem bestehenden Projekt:

openshot-cli session start --project "/home/me/Videos/My Project.osp"

Fügen Sie --show hinzu, um auch das Editorfenster zu öffnen. Um einen bereits laufenden Editor zu verwenden, finden Sie ihn mit session list. Setzen Sie OPENSHOT_SESSION auf die zurückgegebene Sitzungs-ID und öffnen oder prüfen Sie dann ein Projekt:

openshot-cli project open "/home/me/Videos/My Project.osp"
openshot-cli project get

Ersetzen Sie den Beispielpfad durch Ihren eigenen und setzen Sie Pfade mit Leerzeichen in Anführungszeichen. project open ersetzt das aktuelle Projekt der ausgewählten Sitzung. Es verweigert das Verwerfen ungespeicherter Änderungen, es sei denn, Sie fügen ausdrücklich --discard hinzu; speichern Sie diese Änderungen zuerst, wenn Sie sie behalten möchten. Das Öffnen über die CLI zeigt keine interaktiven Dialoge für fehlende Medien an, halten Sie daher die Quellmedien des Projekts verfügbar.

Für ein neues, leeres Projekt verwenden Sie session start ohne --project, importieren dann Medien und fügen Clips hinzu, wie unter Bearbeitung beschrieben.

Speichern eines Projekts oder einer Kopie

Speichern Sie in einer neuen Datei oder erstellen Sie eine separate Version, bevor Sie weitere Änderungen vornehmen:

openshot-cli project save "/home/me/Videos/My Project v2.osp"

Um eine bestehende Datei zu aktualisieren, erlauben Sie ausdrücklich das Überschreiben:

openshot-cli project save "/home/me/Videos/My Project v2.osp" --overwrite

Geben Sie immer den Zielpfad an. Das Speichern einer .osp-Datei packt nicht alle Ihre Quellaufnahmen in diese Datei; halten Sie die referenzierten Medien verfügbar, wenn Sie das Projekt verschieben oder erneut öffnen.

Ein Video exportieren

Automatisieren Sie das Rendern und Exportieren über Skripte oder KI-Agenten, indem Sie die Projekteinstellungen verwenden oder für jeden Export ein anderes Ausgabeprofil wählen. Exportaufträge können im Hintergrund laufen oder auf den Abschluss warten, bevor Ihr Skript fortfährt. Um ein MP4 mit der Auflösung und Bildrate des Projekts zu rendern:

openshot-cli export start "/home/me/Videos/video.mp4" --wait

Standardmäßig verwendet OpenShot H.264-Video und AAC-Audio. Ersetzen Sie den Beispielpfad durch Ihr Ziel, verwenden Sie einen vorhandenen Ordner und einen neuen Dateinamen. Bestehende Ausgaben werden niemals überschrieben. Exportieren speichert Ihr bearbeitbares .osp-Projekt nicht; verwenden Sie project save separat, um Ihre Bearbeitungsarbeit zu sichern.

Die Option --wait hält den Befehl aktiv, bis der Export abgeschlossen ist oder ein Fehler gemeldet wird. Überprüfen Sie das fertige Video, bevor Sie es teilen.

Exportfortschritt prüfen

Lassen Sie --wait weg, um einen Export im Hintergrund zu starten. Die Antwort enthält eine Job-ID, mit der Sie den Fortschritt prüfen können:

openshot-cli export start "/home/me/Videos/video.mp4"
openshot-cli export status JOB_ID
openshot-cli export status JOB_ID --wait
openshot-cli export list

Ersetzen Sie JOB_ID durch die zurückgegebene ID. Wenn die Wartezeit abläuft, läuft der Export weiter; prüfen Sie denselben Job, anstatt einen neuen Export zu starten. Um einen Job zu stoppen, verwenden Sie export cancel JOB_ID. Jeder Job erfasst die Zeitleiste beim Start, sodass spätere Änderungen einen bereits laufenden Export nicht beeinflussen.

Die Wartezeit beträgt standardmäßig 600 Sekunden; passen Sie diese mit --wait-timeout an. Dies ist getrennt vom globalen pro-Anfrage---timeout. Exportfehler, Abbruch und Wartezeitüberschreitungen beenden mit Status 1 und enthalten Jobdetails.

Exportieren in mehreren Profilen

Exportieren Sie dieselbe Zeitleiste in verschiedenen Auflösungen oder Seitenverhältnissen, indem Sie für jede Ausgabe ein Exportprofil wählen. Ein Exportprofil gilt nur für diesen Job; es ändert nicht das Profil des Bearbeitungsprojekts. Ein Profil legt Abmessungen, Bildrate und Seitenverhältnis fest; ein Exportvorgabe wählt Kodierungseinstellungen wie MP4/H.264.

Finden Sie die verfügbaren Profile und prüfen Sie deren Einstellungen:

openshot-cli profile list --search 720
openshot-cli profile list --search 1080
openshot-cli profile get builtin:01280x0720p0030_16-09

Exportieren Sie beispielsweise Landschaftsversionen in 720p und 1080p, dann eine quadratische Version mit 1080 mal 1080. Diese Profile verwenden alle 30 fps:

openshot-cli export start "/home/me/Videos/video-720p.mp4" --profile builtin:01280x0720p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-1080p.mp4" --profile builtin:01920x1080p0030_16-09 --wait
openshot-cli export start "/home/me/Videos/video-square.mp4" --profile builtin:01080x1080p0030_01-01 --wait

Verwenden Sie für jede Version einen anderen Ausgabedateinamen. Halten Sie Änderungen zwischen den Jobs unverändert, wenn Sie passende Versionen wünschen. Das Ändern des Seitenverhältnisses kann die Bildkomposition verändern: Überprüfen Sie jede Ausgabe, besonders Titel und animierte Motive. Für eine separat komponierte quadratische oder Hochformat-Version speichern Sie eine Projektkopie, ändern das Projektprofil und passen die Clips vor dem Export an. Siehe Profile und die Export-Einstellungen unten für benutzerdefinierte Profile und Kodierungsoptionen.

Mehrere Projekte im Stapel exportieren

Verwenden Sie eine Headless-Sitzung, um mehrere gespeicherte Projekte nacheinander zu rendern. Öffnen Sie ein Projekt, exportieren Sie es mit --wait, und öffnen Sie dann das nächste Projekt. Die folgenden Beispiele verwenden jeweils die eigene Auflösung und Bildrate des Projekts und erstellen MP4-Dateien neben den .osp-Dateien. Fügen Sie dem Exportbefehl --profile PROFILE_ID hinzu, um für jedes Projekt ein Ausgabeprofil zu verwenden.

Führen Sie zuerst das oben passende automatische Session-ID-Beispiel erfolgreich im selben Terminal aus. Es definiert openshot und wählt die neue Sitzung aus. Ersetzen Sie die unten stehenden Projektpfade durch Ihre eigenen. Verwenden Sie eindeutige Ausgabennamen, die noch nicht existieren; die Beispiele prüfen alle Ziele, bevor der Batch gestartet wird.

Windows PowerShell:

$projects = @(
    "C:\VideoProjects\First.osp",
    "C:\VideoProjects\Second.osp"
)
foreach ($project in $projects) {
    if (-not (Test-Path -LiteralPath $project -PathType Leaf)) {
        throw "Project not found: $project"
    }
    $output = [System.IO.Path]::ChangeExtension($project, ".mp4")
    if (Test-Path -LiteralPath $output) { throw "Output already exists: $output" }
}
foreach ($project in $projects) {
    $output = [System.IO.Path]::ChangeExtension($project, ".mp4")
    & $openshot --cli project open $project
    if ($LASTEXITCODE -ne 0) { throw "Could not open: $project" }
    & $openshot --cli export start $output --wait --wait-timeout 86400
    if ($LASTEXITCODE -ne 0) { throw "Export needs attention: $output" }
}
& $openshot --cli session stop
if ($LASTEXITCODE -ne 0) { throw "Could not stop the session" }
Remove-Item Env:OPENSHOT_SESSION

Linux Bash (die Klammern halten die Fehlerbehandlung lokal für den Batch):

(
    set -e
    : "${OPENSHOT_SESSION:?Run the session startup example first}"
    projects=(
        "/home/me/VideoProjects/First.osp"
        "/home/me/VideoProjects/Second.osp"
    )
    for project in "${projects[@]}"; do
        test -f "$project" || { echo "Project not found: $project" >&2; exit 1; }
        output="${project%.osp}.mp4"
        test ! -e "$output" || { echo "Output already exists: $output" >&2; exit 1; }
    done
    for project in "${projects[@]}"; do
        "$openshot" --cli project open "$project"
        "$openshot" --cli export start "${project%.osp}.mp4" --wait --wait-timeout 86400
    done
    "$openshot" --cli session stop
) && unset OPENSHOT_SESSION

Beide Rezepte stoppen den Batch bei einem Befehlsfehler und lassen die Sitzung zur Inspektion verfügbar. Die Wartezeitbegrenzung beträgt hier 24 Stunden pro Export. Ein Wartezeitüberschreitung lässt das Rendern laufen: Verwenden Sie export list und export status JOB_ID --wait bevor Sie es erneut versuchen. Fertige Videos bleiben auf der Festplatte; entfernen Sie abgeschlossene Projekte aus dem Batch, bevor Sie fortfahren. Nach der Fehlerbehebung stoppen Sie die Sitzung und löschen die Umgebungsvariable, wenn Sie fertig sind.

Auswahl von Voreinstellungen und Kodierungseinstellungen

Entdecken Sie die installierten Exportvoreinstellungen und unterstützten Einstellungen:

openshot-cli export preset list
openshot-cli export preset get builtin:format_mp4_x264
openshot-cli export capabilities
openshot-cli export start /tmp/reel.mp4 --preset builtin:format_mp4_x264 --quality med --wait

Export akzeptiert auch --from-file FILE_ID mit optionalem --create-custom. Einstellungen werden in folgender Reihenfolge aufgelöst: Projekt-Standardwerte, Voreinstellung, erweitertes JSON, explizite Profil-/Qualitäts-/Bereichs-Flags. Erweitertes JSON zeigt Video-/Audiocodecs und Bitrate, Audio-Layout/Rate/Kanäle, native Codec-Optionen, Hardware-Geräteeinstellungen und Thread-Anzahlen an.

Wählen Sie beispielsweise eine Encoder-Option über erweitertes JSON aus:

openshot-cli export start /tmp/small.mp4 --profile builtin:00640x0360p0030_16-09 --json '{"video_options":{"preset":"fast"}}' --wait

Validierung der Exporteinstellungen

Überprüfen Sie die Einstellungen vor dem Start eines Renderings:

openshot-cli export validate /tmp/reel.mp4 --preset builtin:format_mp4_x264

Der Fähigkeitenbericht zeigt die Verfügbarkeit kompilierter Codecs, nicht die physische GPU-Verfügbarkeit. Die Validierung geht weiter: Sie öffnet die Encoder (einschließlich Hardware-Encoder) und den Container mit den genauen Einstellungen in einem separaten Prozess, ohne eine Datei zu schreiben. Eine Kombination, die der Container nicht halten kann, schlägt mit incompatible_export, FFmpegs eigener Erklärung und der zu ändernden Einstellung (details.cause.path) fehl:

openshot-cli export validate /tmp/song.mp3 --json '{"mode":"audio","format":"mp3","audio_codec":"aac"}'

Der Export-Worker führt vor dem Rendern dieselbe Prüfung durch.

Rendering eines Bildbereichs

Verwenden Sie --start-frame und --end-frame, um einen Teil der Zeitleiste zu rendern. Bereiche sind inklusive und einsbasiert bei der FPS des Exportprofils. Zum Beispiel die ersten 90 Frames bei 30 fps (drei Sekunden) rendern:

openshot-cli export start /tmp/excerpt.mp4 --profile builtin:01280x0720p0030_16-09 --start-frame 1 --end-frame 90 --wait

Nur-Audio-Exporte und Bildsequenzen

Wählen Sie einen Ausgabemodus mit erweitertem JSON:

openshot-cli export start /tmp/music.wav --json '{"mode":"audio","format":"wav","audio_codec":"pcm_s16le"}' --wait
openshot-cli export start /tmp/frames --json '{"mode":"image_sequence","format":"png"}' --end-frame 3 --wait

Bildsequenzen erfordern ein neues Ausgabeverzeichnis. Bestehende Ausgaben werden niemals überschrieben.

Bearbeitung

Hinzufügen von Clips und Effekten

Verwenden Sie die von import/add/list zurückgegebenen IDs und ermitteln Sie die Ebenennummern mit project get:

openshot-cli file import /absolute/path/video.mp4
openshot-cli clip add FILE_ID --layer 2000000 --position 3 --start 10 --end 17 --volume 0
openshot-cli clip set CLIP_ID --json '{"volume":0.5}'
openshot-cli clip keyframe set CLIP_ID --property volume --frame 301 --value 0
openshot-cli clip keyframe set CLIP_ID --property volume --frame 331 --value 1
openshot-cli effects add CLIP_ID saturation
openshot-cli effects set EFFECT_ID --json '{"saturation":1.2}'
openshot-cli project save /absolute/path/edit.osp

Wählen Sie das Projektprofil möglichst früh; befüllte Projekte unterstützen auch Profiländerungen über das bestehende FPS-Konvertierungs- und Rückgängigmach-System. --audio-only bei der Clip-Erstellung unterdrückt Video, einschließlich eingebetteter Cover-Art in Musikdateien. Um diesen Clip stattdessen für Audio-Visualisierung zu verwenden, aktivieren Sie Video und Audio und folgen Sie der Hilfe des Effekts für transparente Überlagerungen und Ebenenplatzierung.

Verständnis der Clip-Timing

Die Beispiel-Keyframes gehen von einem 30fps-Projekt und einem Clip aus, der bei Quelle 10s beschnitten wurde. Position ist in Zeitleisten-Sekunden; Start/Ende sind Quell-Sekunden, wobei Ende exklusiv ist. Frames beginnen bei 1. Dateivorschau-Frames verwenden Quell-FPS. Zeitleisten-Frames verwenden Projekt-FPS. Clip-Keyframes verwenden Quellkoordinaten bei Projekt-FPS, sodass das Beschneiden des Clips seinen ersten sichtbaren Keyframe nicht auf Frame 1 verschiebt.

Eigenschaften ändern

set fügt oberste Eigenschaften zusammen. Skalare machen keyframte Eigenschaften zu Konstanten. Eine angegebene verschachtelte Kurve ersetzt diese Kurve; verwenden Sie keyframe set, um nur einen Punkt zu ändern. JSON-Argumente akzeptieren Inline-JSON, @file.json oder - für stdin. Eigenschaftsnamen, Typen, Enums, Keyframes, Referenzen und Timing werden vor der Projektbearbeitung validiert. Fehler identifizieren das Feld, den erwarteten Wert, den erhaltenen Wert und eine Korrektur, wo möglich. GUI-Schiebereglerbereiche sind beratend, wenn die Engine Werte darüber hinaus unterstützt.

Hinzufügen von Überblendungen

clip fade ID --in 0.5 --out 0.5 berechnet automatisch die Keyframe-Koordinaten des Quellbeschnitts. Es ersetzt die Alphakurve; --property volume --value 0.25 erzeugt stattdessen eine Audio-Überblendung mit einem Spitzenwert von 0,25. Die Dauer muss zwischen dem ersten und letzten sichtbaren Frame liegen; das Ausblenden erreicht im letzten Frame Null.

Clips teilen

clip split ID --at 6.5 verwendet Zeitleisten-Sekunden, schnappt zum nächsten Projekt-Frame und behält beide Hälften. Es behält Quellkoordinatenkurven und dupliziert Effekte mit neuen IDs auf der rechten Hälfte, entsprechend dem Schneideverhalten des Editors. Die linke Hälfte behält ihre ID. Die Antwort meldet angeforderte/tatsächliche Schnittzeiten und beide Zusammenfassungen; ein benanntes Batch-Ergebnis unterstützt {"$ref":"cut.right.id"}. Schnitte lehnen Endpunkte und gesperrte Spuren ab. Rückgängig stellt den Originalclip in einer Transaktion wieder her.

Clip-Menü-Voreinstellungen

Die Clip-Menü-Voreinstellungen des Editors verwenden denselben Code wie die Befehlszeile. Jeder Befehl listet seine Voreinstellungen in seiner Hilfe auf, und jede ist ein einzelner Rückgängig-Schritt:

openshot-cli clip motion CLIP_ID --preset slide-in-left
openshot-cli clip motion CLIP_ID --preset pulse --at 4.5
openshot-cli clip look CLIP_ID --effect ColorGrade --preset warm_up
openshot-cli clip look CLIP_ID --effect all --preset none
openshot-cli clip speed CLIP_ID --mode forward --factor 2
openshot-cli clip speed CLIP_ID --mode freeze --at 3 --duration 2
openshot-cli clip repeat CLIP_ID --passes 3 --pattern pingpong
openshot-cli clip waveform CLIP_ID

Bewegungsvoreinstellungen beziehen sich auf die aktuelle Transformation des Clips. Look-Voreinstellungen fügen einen Effekt hinzu oder ersetzen ihn, und none entfernt ihn. Geschwindigkeit und Wiederholung ändern die Zeit jedes Keyframes und die Länge des Clips; clip speed --mode reset stellt die normale Geschwindigkeit wieder her. Andere Menüaktionen sind einfache Bearbeitungen: Drehen und Layout mit clip set, Zuschneiden mit effects add Crop. Die Befehle funktionieren auch in edit apply und edit bulk.

Text hinzufügen und gestalten

text add erstellt einen Text und platziert ihn als Clip, wobei derselbe Text wie im Text-Werkzeug des Editors verwendet wird. Optionen, die Sie weglassen, verwenden den Standardstil des Editors:

openshot-cli text add --text "Opening Night" --layer 5000000 --position 2 --duration 4 \
    --place lower-third --font "Noto Sans" --size 72 --bold --color "#ffffff" \
    --background "#80000000" --background-padding 16 --background-corner 12
openshot-cli text get CLIP_ID
openshot-cli text set CLIP_ID --stroke black --stroke-width 3
openshot-cli text set CLIP_ID --text $'Two\nlines' --line-spacing 1.4
openshot-cli text fonts --search noto
openshot-cli text list --search opening

Die Wörter, Schriftart, Größe, Ausrichtung, Boxbreite und Standardfarben gehören zum Text in den Projektdateien und werden von jedem Clip geteilt, der ihn verwendet, genau wie im Editor. text set bei einem Clip ändert alle und listet sie in changed_clip_ids auf; --this-clip-only gibt diesem Clip zuerst eine eigene Kopie. clip add FILE_ID fügt einen weiteren Clip eines Textes aus text list hinzu. Größen sind in Pixeln bei der Projektauflösung, und Farben sind #RRGGBB, #AARRGGBB (mit Alpha), ein CSS-Name oder transparent. --place positioniert die Box in der Mitte, an einer Kante oder Ecke oder im unteren Drittel. --line-spacing ist ein Vielfaches des normalen Abstands zwischen Zeilen (1 ist normal), und --background-corner rundet die Ecken von Hintergrund und Rahmen um so viele Pixel.

Ein Textclip ist ein gewöhnlicher Clip. Position, Skalierung, Rotation, Deckkraft, Timing, Überblendungen, Bewegungsvoreinstellungen und Effekte verwenden alle die normalen clip-Befehle. Schriftgröße, Innenabstand, Boxbreite sowie Buchstaben- und Zeilenabstand bestimmen die Größe des Textfelds, daher können sie nicht mit Keyframes versehen werden; um die Textgröße zu animieren, keyframen Sie die Skalierung des Clips. Jeder Clip kann seine eigenen Textfarben sowie Umriss- und Rahmenbreiten mit denselben Keyframe-Befehlen wie jede andere Eigenschaft animieren:

openshot-cli clip keyframe list CLIP_ID
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 0 --value 0
openshot-cli clip keyframe set CLIP_ID --property text_color.alpha --space clip --unit seconds --at 1 --value 255

Die animierten Eigenschaften sind text_color, text_background, text_stroke und text_border (Farben mit .red, .green, .blue und .alpha von 0 bis 255), sowie text_stroke_width, text_border_width und text_background_corner. Die eigene Animation eines Clips hat Vorrang vor dem geteilten Stil, und text get listet auf, welche Stile ein Clip animiert. text reset CLIP_ID setzt einen Clip auf den Standardstil zurück, wie Text → Stil zurücksetzen; --keyframes-only entfernt nur die eigene Animation des Clips. Um viele Texte gleichzeitig zu gestalten, wählen Sie sie mit {"text":true}:

openshot-cli edit bulk --select '{"text":true}' --json '[{"method":"text.set","params":{"font_family":"Noto Sans","stroke_width":2}}]'

Anwenden einer Reihe von Bearbeitungen

edit apply --json @edits.json --expect-revision 12 akzeptiert bis zu 256 geordnete Änderungsbefehle, die punktierte Befehlsnamen wie clip.set und effects.add verwenden (die ältere Schreibweise effect.add funktioniert ebenfalls):

[
  {"method":"project.profile.set","params":{"id":"builtin:01280x0720p0024_16-09"}},
  {"method":"file.import","as":"media","params":{"path":"/tmp/video.mp4"}},
  {"method":"clip.add","as":"shot","params":{"file_id":{"$ref":"media.id"},"layer":1000000,"start":10,"end":15}},
  {"method":"clip.fade","params":{"id":{"$ref":"shot.id"},"fade_in":0.5,"fade_out":0.5}}
]

Das optionale as bindet ein Ergebnis für spätere Befehle im selben Batch. Ein {"$ref":"shot.id"}-Objekt ersetzt das Feld dieses Ergebnisses. Referenzen lösen nur frühere Namen auf; Rechtschreibfehler, Vorwärtsreferenzen und doppelte Namen schlagen vor Live-Updates fehl. Die Antwort enthält geordnete kompakte Ergebnisse und eine refs-Karte der tatsächlichen IDs. Alle Änderungen in einem erfolgreichen Batch bilden einen Rückgängig/Wiederherstellen-Schritt. project.profile.set unterstützt auch gefüllte Zeitachsen. Öffnen-, Speichern-, Exportieren- und Inspektionsbefehle bleiben außerhalb von Edit-Batches. Die Hilfe jedes Befehls listet seine JSON-Parameter-Namen auf, einschließlich der Unterstrich-Schreibweise von Shell-Flags (zum Beispiel wird --fps-num zu fps_num).

Validierung von Batches und Fehlerbehandlung

Alle Befehle in Edit-Batches werden vor Live-Updates an einem losgelösten Projekt geprüft. Ungültige Eingaben lassen das Live-Projekt und die Revision unverändert. Gültige Batches bilden eine Rückgängig-Gruppe. Unerwartete Laufzeitfehler können dennoch Teiländerungen verursachen; Fehler melden abgeschlossene Operationen. Ein Timeout bedeutet keine Abbruch, daher prüfen Sie den Zustand vor dem erneuten Versuch von Änderungen.

Präzise Keyframe-Bearbeitung

clip, transition und effects unterstützen keyframe list, set, remove, clear, transform, copy und paste. Eigenschaftspfade können verschachtelte Kurven adressieren, wie color.red bei einem Chroma-Key-Effekt. Das Bearbeiten einer verschachtelten Kurve erhält die benachbarten Kanäle. Führen Sie keyframe list ID ohne Eigenschaft aus, um Kurvenpfade und Punktanzahlen zu entdecken. Entdeckung und Punktauflistungen enthalten Trim-/Positions-Timing-Kontext; Punktauflistungen berichten auch native Frame-Koordinaten. get und properties zeigen das vollständige native Objekt und die Eigenschaftsmetadaten an. Fehler identifizieren ungültige Felder, schlagen ähnliche Eigenschaftsnamen vor und erklären Koordinatenkorrekturen.

Wählen Sie Koordinaten explizit mit --space native|clip|timeline und --unit frames|seconds. Alle Frames verwenden die Projekt-FPS und sind 1-basiert; Sekunden beginnen bei null und rasten am nächsten Frame ein. Native ist die bestehende Engine-Keyframe-Koordinate (einschließlich Quell-Trim). Clip-Koordinaten beginnen am sichtbaren Clip-In-Punkt; Timeline-Koordinaten beginnen bei Projektzeit Null. Angeschlossene Effekte verwenden das Timing ihres übergeordneten Clips. Diese Koordinaten beziehen sich auf Animationszeit, nicht auf die Medienframes, die durch eine Zeit-Neuzuordnungskurve ausgewählt wurden.

Für einen Clip, der bei 5 Sekunden positioniert und bei 2 Sekunden beschnitten ist, in einem 30 fps Projekt, entsprechen Clip-Frame 1, Timeline-Frame 151 und nativer Frame 61 demselben Punkt. Position und Beschnitt rasten unabhängig am Projekt-Frame-Raster ein. Das Auflisten einer gesamten Kurve kann versteckte Punkte mit nicht-positiven Clip-/Timeline-Koordinaten enthalten. Das veraltete --frame bedeutet weiterhin einen nativen Frame und kann nicht mit --at kombiniert werden.

Beispiele:

openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 0 --value -1
openshot-cli clip keyframe set CLIP --property location_x --space clip --unit seconds --at 1 --value 0 --interpolation bezier --handles '{"handle_left":{"X":0.2,"Y":0.9}}'
openshot-cli effects keyframe set EFFECT --property color.red --space clip --at 31 --value 200
openshot-cli clip keyframe list CLIP --property location_x --space clip --unit seconds
openshot-cli clip keyframe transform CLIP --property location_x --space clip --start 1 --end 31 --scale 2 --offset 15
openshot-cli clip keyframe copy TARGET --property location_x --source-id SOURCE --space clip --start 1 --end 31 --at 1 --mode merge
openshot-cli clip keyframe remove CLIP --property location_x --space clip --at 31
openshot-cli clip keyframe clear CLIP --property location_x --value 0

Interpolation, Easing und Vorschau

Interpolation beschreibt das Segment zum Zielpunkt hin. Linear liefert eine konstante Rate zwischen den Punkten. Konstant hält den vorherigen Wert bis zum Ziel und springt dann. Die native Standard-Bezier-Kurve sorgt für eine sanfte Bewegung an beiden Enden jedes Segments. Das Hinzufügen eines Zwischenpunkts kann daher eine unbeabsichtigte Verlangsamung verursachen; für eine sanfte Bewegung beginnt man mit zwei Endpunkten. Normalerweise lässt man die Griffe unverändert und wählt ein benanntes Preset für einen bestimmten Stil.

Entdecken Sie dieselben Easing-Presets, die in den Menüs des Editors verwendet werden, ohne eine Sitzung:

openshot-cli clip keyframe presets

Wenden Sie ein Preset auf das eingehende Segment an, indem Sie dessen Ziel setzen:

openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 0 --value 1
openshot-cli clip keyframe set CLIP --property scale_x --space clip --unit seconds --at 4 --value 1.2 --easing ease-in-out

Die Easing-Option impliziert Bezier. Sie setzt den ausgehenden Griff des vorherigen Punkts und den eingehenden Griff des Ziels zusammen, wobei andere Griffe und Punktwerte erhalten bleiben. Ein früherer Punkt muss existieren. Kombinieren Sie dies nicht mit benutzerdefinierten Griffen oder einer anderen Interpolation. Presets funktionieren in Batches und Massen-Vorlagen. Das GUI-Preset ease („Ease (Standard)“) unterscheidet sich von den nativen Griffen, die bei einfacher Bezier-Interpolation verwendet werden. Back-Presets können Endpunktwerte überschießen.

Bewegen Sie sich vor dem Rendern mit dem nativen Kurven-Auswerter:

openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --start 0 --end 4
openshot-cli clip keyframe preview CLIP --property scale_x --space clip --unit seconds --at 2

Die Vorschau ist schreibgeschützt und funktioniert identisch für Effekte und Übergänge. Sie liefert Werte und signierte eingehende/ausgehende Raten in Eigenschaftseinheiten pro Sekunde, berechnet aus unmittelbar benachbarten Frames. Dies sind endliche Differenzen, keine analytischen Ableitungen. Beim nativen Frame 1 ist die eingehende Rate null. Raten benachbarter Frames können außerhalb des angeforderten Bereichs prüfen. Nahe Null liegende Raten um einen inneren Punkt zeigen eine Pause; unterschiedliche Raten zeigen eine Geschwindigkeitsänderung. Konstante Interpolation zeigt einen Sprung am Zielpunkt.

Ohne Bereich erstreckt sich die Vorschau über den ersten und letzten Punkt der Kurve. Bereiche sind inklusive, mit standardmäßig 17 gleichmäßig verteilten Samples (–count: 2–256). Keyframes und ihre unmittelbaren Nachbarn innerhalb des Bereichs sind ebenfalls enthalten, sodass eine geringe Sample-Anzahl keinen Keyframe-Stopp verbirgt. Das Maximum sind 1024 Samples; größere Anfragen erfordern einen engeren Bereich. –at sampelt einen Frame. Die Vorschau meldet Koordinaten im angeforderten Raum und tatsächliche native Frames; Sekunden rasten wie beim Bearbeiten an Projekt-Frames ein.

Für erweiterte benutzerdefinierte Griffe sind sowohl X als auch Y auf das Segment normiert: X ist ein Bruchteil seiner Frame-Spanne; Y ist ein Bruchteil seiner Wertänderung. Die erste Steuerung stammt vom handle_right des vorherigen Punkts, die zweite vom handle_left des Ziels. Native Standardwerte sind rechts=(0.5, 0), links=(0.5, 1), mit flachen Endpunkt-Tangenten. Das Ändern des handle_type allein berechnet keine kontinuierliche Tangente durch umliegende Punkte neu. Bestehende Griffe bleiben beim Verschieben eines Punkts erhalten.

Keyframe-Bereiche sind inklusive, im Gegensatz zu Zeitbereichen der Clip-Auswahl. List gibt points aus, deren co.X-Werte den angeforderten Koordinatenraum/-einheit verwenden. Übergeben Sie dieses Array an keyframe paste --json @points.json mit demselben Raum/Einheit und wählen Sie --mode merge (ersetze passende Frames, behalte andere) oder --mode replace (ersetze die gesamte Kurve). copy akzeptiert eine Quelle desselben Objekttyps, eine optionale --source-property und verankert den ersten ausgewählten Quellpunkt bei --at auf dem Ziel. Andere Kurven und Quellobjekte bleiben unverändert.

transform wendet eine positive Zeitskalierung um den ersten ausgewählten Punkt oder --pivot an, gefolgt von einem vorzeichenbehafteten --offset in der gewählten Einheit. Frame-Rasterung, die doppelte Koordinaten erzeugt, wird abgelehnt, einschließlich Kollisionen mit Punkten außerhalb des ausgewählten Bereichs. Native Koordinaten müssen mindestens 1 bleiben. Native normalisierte Bézier-Griffe und Interpolation bewegen sich mit jedem Punkt; Griffe sind keine absoluten Frame-Koordinaten. set --handles ändert nur die angegebenen Griffe. Die Interpolation gehört zum Zielpunkt.

clear behält einen konstanten Basispunkt bei nativen Frame 1: Geben Sie --value an oder sampeln Sie die bestehende Kurve mit --at (Standard ist nativer Frame 1). Das Entfernen des letzten Punkts behält ebenfalls eine konstante Basis bei, sodass nachfolgende Keyframe-Hinzufügungen gültig bleiben.

Auswählen und Bearbeiten vieler Clips

Verwenden Sie edit apply --dry-run, um einen Batch zu validieren, ohne das Projekt zu ändern. Verwenden Sie edit bulk, um eine kleine Befehlsvorlage für jeden ausgewählten Clip zu wiederholen, wobei alle Änderungen in einem einzigen Rückgängig-Schritt gruppiert werden.

Zuerst eine Auswahl vorschauen:

openshot-cli edit select --json '{"layer":1000000,"start":5,"end":20,"effect":"Saturation"}'

Selektoren unterstützen ids (einzigartiges Clip-ID-Array), layer, start/end (Timeline-Sekunden), file_id, effect (Klassenname oder Alias) und text (true wählt Textclips aus). Filter werden mit UND kombiniert. Zeitbereiche wählen Clips aus, die [start, end) überlappen; sie schneiden diese Clips nicht zu. Ergebnisse sind nach Position, Ebene und dann ID sortiert und enthalten IDs, Zusammenfassungen, Sperrstatus und die aktuelle Revision. Unbekannte IDs sind Fehler. Ein leerer Selektor wird abgelehnt; verwenden Sie explizit {"all":true} für jeden Clip. Auswahlen sind auf 256 Clips begrenzt und werden niemals stillschweigend abgeschnitten.

Speichern Sie beispielsweise dieses Array als templates.json:

[
  {"method":"clip.adjust","params":{"values":{"position":{"add":2},"volume":{"multiply":0.5}}}},
  {"method":"effects.add","as":"look","params":{"type":"Saturation"}},
  {"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":1,"value":0}},
  {"method":"effects.keyframe.set","params":{"id":{"$ref":"look.id"},"property":"saturation","space":"clip","at":31,"value":1.2}}
]

Validieren Sie es und wenden Sie es dann auf die durch die Auswahl zurückgegebene Revision an:

openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --dry-run
openshot-cli edit bulk --select '{"ids":["CLIP_A","CLIP_B"]}' --json @templates.json --expect-revision 42

Befehle für vorhandene Clips erben id; effects.add erbt clip_id. Lassen Sie diese Zielparameter in Vorlagen weg. Effektbearbeitungen müssen auf ein früher benanntes Ergebnis verweisen. Namen sind lokal für jeden ausgewählten Clip, daher bezieht sich look.id auf einen anderen Effekt für jeden Clip. Um vorhandene Effektinstanzen durch explizite ID zu ändern, verwenden Sie weiterhin edit apply. Die ausgewählte ID-Menge ist vor der Erweiterung festgelegt; Änderungen an Position oder Effekten ändern die verbleibenden Ziele nicht.

clip set wendet absolute Eigenschaften an; clip adjust wendet multiply und dann add auf eine numerische Eigenschaft oder jeden Wert in einer Kurve an, wobei Punktzeitpunkt, Interpolation und normalisierte Griffe erhalten bleiben. Es validiert die resultierenden Werte, einschließlich nicht-negativer Positionen und Lautstärke. Strukturelle Felder bleiben geschützt.

Massenoperationen lehnen leere Auswahlen, gesperrte Zielspuren und mehr als 256 erweiterte Befehle ab. Jede erweiterte Operation durchläuft vor der Live-Bearbeitung eine getrennte Vorprüfung. Trockenläufe reservieren keine generierten IDs. Verwenden Sie --expect-revision, um veraltete Auswahlen abzulehnen. Erfolgreiche Chargen sind ein Rückgängigmachungsschritt, auch nach Speichern/Wiederöffnen. GUI-Aktualisierungen werden gebündelt. Unerwartete Laufzeit-/Listener-Fehler können dennoch eine teilweise Transaktion hinterlassen; der Fehler meldet abgeschlossene Operationen und Rückgängig macht diese Gruppe, wie bei edit apply.

Profile

Profile entdecken und importierte Videos ohne Schätzung der IDs zuordnen:

openshot-cli profile list --search 720
openshot-cli profile get builtin:01280x0720p0024_16-09
openshot-cli profile match --file FILE_ID
openshot-cli project profile get
openshot-cli project profile set --from-file FILE_ID
openshot-cli project profile set builtin:01280x0720p0024_16-09
openshot-cli project profile set --json '{"width":640,"height":352,"display_ratio":{"num":20,"den":11},"fps":{"num":24000,"den":1001}}'

Katalogeinträge enthalten stabile IDs, Beschreibungen, Abmessungen, rationale FPS, Seitenverhältnisse und Scan-Einstellungen. Liste/Suche ist paginiert. Quellenabgleich liefert exakte IDs und bewertete Alternativen mit expliziten Unterschieden. Das Einstellen aus einer Datei erfordert eine exakte Übereinstimmung, es sei denn, --create-custom ist angegeben; es wählt niemals stillschweigend ein nahegelegenes Profil. Standbilder und nur Audioquellen können kein Videoprofil definieren. Der Abgleich verwendet die deklarierte Quell-FPS.

Benutzerdefinierte Einstellungen sind im gespeicherten Projekt eingebettet, einschließlich rationaler Raten, sodass das erneute Öffnen keine separate Profil-Datei erfordert. Änderungen am Projektprofil verwenden vorhandene Bildratenkonvertierung und eine Rückgängig-Transaktion. Rückgängig/Wiederholen stellt Clip-Timing und Keyframes wieder her, einschließlich positionssensibler Rundungen. Der Export kann unabhängig ein Profil auswählen, ohne das Projekt zu ändern.

Die gespeicherte Rückgängig-Historie folgt der History-Limit-Einstellung des Editors. Das Limit ist ein weiches Aktionsbudget: Alle Datensätze zu behaltenen Transaktionen werden aufbewahrt, sodass das Speichern eine große Charge nicht in eine teilweise Rückgängig-Aktion kürzen kann. Null deaktiviert die gespeicherte Historie. Die separate Grenze von 256 Befehlen pro Batch-Anfrage gilt weiterhin.

Medien und Zeitachsen inspizieren

Clip-Timing und Spurenlayout als Text oder JSON inspizieren oder Bilder rendern, um Komposition und Bildausschnitt vor dem Export zu überprüfen.

Zeitachsen-Zusammenfassungen

Verwenden Sie eine Textansicht für eine schnelle Übersicht oder strukturiertes JSON für Skripte und Agenten:

openshot-cli timeline view --start 5 --end 12
openshot-cli timeline view --start 5 --end 12 --format json
openshot-cli timeline overview --start 5 --end 12

timeline view verwendet standardmäßig kompakten Text mit verwendeten Spuren, Objekt-IDs, Zeitachsen-/Quellintervallen, Stream-Zustand, Verstärkung sowie Lücken/Überlappungen. Verwenden Sie --detail summary|clips|full, um Details auszuwählen, --format json für strukturierten Kontext und --start/--end, --layer sowie Paginierung, um das Ergebnis zu fokussieren.

timeline overview liefert kompakten strukturierten Kontext ohne Bilddaten: geordnete IDs, Sequenz pro Spur, Zeitachsen-/Quellintervalle, sichtbare Schnittbereiche, Frame-Koordinaten, Audio-/Video-Zustand, Effekte sowie benachbarte Lücken oder Überlappungen. Intervalle und Frame-Spannen sind end-exklusiv; Frame-Nummern sind einsbasiert. Quellframes verwenden Quell-FPS; Zeitachsen- und Keyframe-Koordinaten verwenden Projekt-FPS. Verwenden Sie --layer und --start/--end zum Fokussieren sowie --limit/--offset zur Paginierung (Standard 100, maximal 500 Elemente). Zeitlich umgesetzte Clips enthalten explizit keine abgeleiteten Quellzuordnungen. Verwenden Sie die zurückgegebene Revision mit edit apply --expect-revision.

Frame-Vorschauen und Kontaktbögen

Rendern Sie einen einzelnen Frame mit thumbnail oder sampeln Sie einen Bereich mit strip. Verwenden Sie file, um Quellmedien zu inspizieren, und timeline, um das zusammengesetzte Video einschließlich Effekten und geschichteten Clips zu inspizieren:

openshot-cli file thumbnail FILE_ID --frame 301 --output /tmp/source.png
openshot-cli file strip FILE_ID --start 10 --end 20 --count 12 --output /tmp/source-strip.png
openshot-cli timeline thumbnail --frame 91 --output /tmp/timeline-frame.png
openshot-cli timeline strip --start 0 --end 20 --count 12 --output /tmp/timeline-strip.png

Frame-Bilder haben standardmäßig 320x180 Pixel; Kontaktbögen standardmäßig 160x90 pro Kachel plus Timecode-Beschriftungen. Verwenden Sie --width und --height, um die Ausgabepixel zu wählen. Antworten enthalten genaue Sample-/Frame-Metadaten. Kontaktbögen helfen, die Komposition über eine Sequenz zu überprüfen; verwenden Sie Keyframe-Vorschauen und gerendertes Video, um die Bewegung zwischen diesen Samples zu beurteilen.

Zeitleistenbilder

Erfassen Sie das Spur-Layout des Editors, einschließlich Lineal, Miniaturansichten, Effekten, Übergängen und Wellenformen:

openshot-cli timeline view --start 0 --end 20 --pixels-per-second 80 --output /tmp/tracks.png

Die Angabe von --output wählt das Bildformat aus; --format image wählt es ebenfalls explizit aus. Die Aufnahme ändert weder die Ansicht noch das Projekt des Editors. Antworten enthalten Clip-IDs und Zeitangaben neben den Pixelgrenzen.

Bilder haben standardmäßig eine Breite von 1280 Pixeln, die Höhe wird an die verwendeten Spuren angepasst. Verwenden Sie --width, --height oder --all-tracks, um das Layout anzupassen, und --track-size oder --track-label-width, um Spuren und Beschriftungen anzupassen. Der Start-/Endbereich bestimmt den Zoom; --pixels-per-second leitet stattdessen die Breite aus dem Zeitbereich ab.

Audio-Wellenformansichten

Wählen Sie --mode waveforms, um Audiohüllkurven auf der Zeitleiste zu inspizieren:

openshot-cli timeline view --start 5 --end 12 --mode waveforms --output /tmp/waves.png

--mode auto verwendet die vorhandene zwischengespeicherte Wellenformanzeige; --mode thumbnails zeigt stattdessen Miniaturansichten. Wellenformen stellen Quellspitzen-/RMS-Pegel mit Clip-Lautstärke- und Zeitkorrekturen dar, vor Audioeffekten oder Mischung.

Nicht zwischengespeicherte Wellenformextraktion dekodiert ganze Quellen, begrenzt auf 600 Sekunden pro Quelle und 1200 Quellen-Sekunden pro Anfrage. Das Verengen des sichtbaren Bereichs reduziert diese Dekodierarbeit nicht. Für längere Quellen erzeugen Sie zuerst Wellenformen im Editor oder verwenden den Miniaturansichtsmodus. Nachfolgende Anfragen können zwischengespeicherte Wellenformen wiederverwenden.

Bildausgabe und Grenzen

Bildpfade müssen neue PNG-Dateien in vorhandenen Verzeichnissen sein. Bilder sind auf 4096 Pixel pro Achse, 8.388.608 Gesamtpixel und 64 Kontaktbogen-Proben begrenzt. Anfragen, die diese Grenzen überschreiten, schlagen vor dem Rendern fehl.

Bilder werden in Dateien geschrieben; JSON-Antworten enthalten deren Pfade und image_bytes-Größen. Die Inspektion wartet auf den Abschluss des Bildes, und große Anfragen können den Editor kurzzeitig beanspruchen.

Umgang mit Befehlszeitüberschreitungen

Eine Zeitüberschreitung einer Anfrage bedeutet nicht, dass eine Änderung fehlgeschlagen ist. Verwenden Sie die Vorgangs-ID im Fehler mit operation get ID, bevor Sie es erneut versuchen. operation list zeigt kürzliche Änderungen sowie deren Status, Revisionen und Ergebnisse an. Abgeschlossene Vorgänge behalten ihre Ergebnisse, wenn sie klein genug sind, einschließlich zurückgegebener Objekt-IDs. Der Speicher ist auf 100 Vorgänge und 4 MiB begrenzt, wobei einzelne Ergebnisinhalte über 256 KiB ausgelassen werden. Diese Aufzeichnungen gelten nur für die laufende Sitzung. Sie stellen Projekte nach einem Absturz nicht wieder her und verhindern nicht, dass ein wiederholter Befehl dieselbe Änderung erneut anwendet. Exportaufträge haben eigene Status-/Listenbefehle.