Was macht cli-anything-kdenlive?
Eine zustandsbehaftete Befehlszeilenschnittstelle für die Videobearbeitung, die denselben Mustern wie die Blender-CLI-Harness folgt. Verwendet ein JSON-Projektformat mit MLT-XML-Generierung für Kdenlive/melt.
Installation
Diese CLI wird als Teil des cli-anything-kdenlive-Pakets installiert:
pip install cli-anything-kdenlive
Voraussetzungen:
- Python 3.10+
- kdenlive muss auf Ihrem System installiert sein
Verwendung
Grundlegende Befehle
# Hilfe anzeigen
cli-anything-kdenlive --help
# Interaktiven REPL-Modus starten
cli-anything-kdenlive
# Neues Projekt erstellen
cli-anything-kdenlive project new -o project.json
# Mit JSON-Ausgabe ausführen (für Agentenverarbeitung)
cli-anything-kdenlive --json project info -p project.json
REPL-Modus
Wenn ohne Unterbefehl aufgerufen, startet die CLI eine interaktive REPL-Sitzung:
cli-anything-kdenlive
# Befehle interaktiv mit Tab-Vervollständigung und Verlauf eingeben
Befehlgruppen
Projekt
Projektverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
new | Ein neues Projekt erstellen |
open | Ein vorhandenes Projekt öffnen |
save | Das aktuelle Projekt speichern |
info | Projektinformationen anzeigen |
profiles | Verfügbare Videoprofile auflisten |
json | Rohes Projekt-JSON ausgeben |
Bin-Gruppe
Befehle zur Verwaltung des Medien-Bins.
| Befehl | Beschreibung |
|---|---|
import | Einen Clip in den Medien-Bin importieren |
remove | Einen Clip aus dem Bin entfernen |
list | Alle Clips im Bin auflisten |
get | Detaillierte Clip-Informationen abrufen |
Timeline
Befehle zur Timeline-Verwaltung.
| Befehl | Beschreibung |
|---|---|
add-track | Eine Spur zur Timeline hinzufügen |
remove-track | Eine Spur entfernen |
add-clip | Einen Clip zu einer Spur hinzufügen |
remove-clip | Einen Clip von einer Spur entfernen |
trim | Ein- und Ausstiegspunkte eines Clips trimmen |
split | Einen Clip an einem Zeit-Offset teilen |
move | Einen Clip an eine neue Position verschieben |
list | Alle Spuren auflisten |
Filter-Gruppe
Befehle zur Filter-/Effektverwaltung.
| Befehl | Beschreibung |
|---|---|
add | Einen Filter zu einem Clip hinzufügen |
remove | Einen Filter von einem Clip entfernen |
set | Einen Filterparameter setzen |
list | Filter auf einem Clip auflisten |
available | Alle verfügbaren Filter auflisten |
Übergang
Befehle zur Übergangsverwaltung.
| Befehl | Beschreibung |
|---|---|
add | Einen Übergang zwischen Spuren hinzufügen |
remove | Einen Übergang entfernen |
set | Einen Übergangsparameter setzen |
list | Alle Übergänge auflisten |
Führung
Befehle zur Führungs-/Markierungsverwaltung.
| Befehl | Beschreibung |
|---|---|
add | Eine Führung an einer Position (Sekunden) hinzufügen |
remove | Eine Führung entfernen |
list | Alle Führungen auflisten |
Export
Befehle zum Exportieren und Rendern.
| Befehl | Beschreibung |
|---|---|
xml | Kdenlive/MLT XML generieren |
presets | Verfügbare Rendervoreinstellungen auflisten |
Sitzung
Befehle zur Sitzungsverwaltung.
| Befehl | Beschreibung |
|---|---|
status | Sitzungsstatus anzeigen |
undo | Die letzte Operation rückgängig machen |
redo | Die letzte rückgängig gemachte Operation wiederherstellen |
history | Undo-Verlauf anzeigen |
Beispiele
Ein neues Projekt erstellen
Erstellen Sie eine neue Kdenlive-Projektdatei.
cli-anything-kdenlive project new -o myproject.json
# Oder mit JSON-Ausgabe für programmatische Nutzung
cli-anything-kdenlive --json project new -o myproject.json
Interaktive REPL-Sitzung
Starten Sie eine interaktive Sitzung mit Undo/Redo-Unterstützung.
cli-anything-kdenlive
# Befehle interaktiv eingeben
# 'help' verwenden, um verfügbare Befehle zu sehen
# 'undo' und 'redo' für die Verlaufsnavigation verwenden
Projekt exportieren
Exportieren Sie das Projekt in ein endgültiges Ausgabeformat.
cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite
Zustandsverwaltung
Die CLI verwaltet den Sitzungszustand mit:
- Undo/Redo: Bis zu 50 Ebenen Verlauf
- Projektpersistenz: Projektzustand als JSON speichern/laden
- Sitzungsverfolgung: Änderungen und Modifikationen verfolgen
Ausgabeformate
Alle Befehle unterstützen zwei Ausgabemodi:
- Lesbar für Menschen (Standard): Tabellen, Farben, formatierter Text
- Maschinenlesbar (
--json-Flag): Strukturiertes JSON für Agentenverarbeitung
# Ausgabe für Menschen
cli-anything-kdenlive project info -p project.json
# JSON-Ausgabe für Agenten
cli-anything-kdenlive --json project info -p project.json
Für KI-Agenten
Bei programmatischer Verwendung dieser CLI:
- Immer
--json-Flag verwenden für parsbare Ausgabe - Rückgabecodes prüfen - 0 für Erfolg, ungleich Null für Fehler
- Stderr parsen für Fehlermeldungen bei Fehlschlag
- Absolute Pfade verwenden für alle Dateioperationen
- Existenz der Ausgaben überprüfen nach Exportoperationen
Weitere Informationen
- Vollständige Dokumentation: Siehe README.md im Paket
- Testabdeckung: Siehe TEST.md im Paket
- Methodik: Siehe HARNESS.md im cli-anything-plugin
Version
1.0.0