cli-anything-openscreen

Was macht cli-anything-openscreen?

Ein zustandsorientiertes Kommandozeileninterface zum Bearbeiten von Bildschirmaufnahmen. Verwandeln Sie rohe Aufnahmen in polierte Demovideos mit Zoom-Effekten, Geschwindigkeitsanpassungen, Trimmen, Anmerkungen und schönen Hintergründen.

Installation

pip install cli-anything-openscreen

Voraussetzungen:

• Python 3.10+
• ffmpeg muss auf Ihrem System installiert sein

Verwendung

Grundlegende Befehle

cli-anything-openscreen --help
cli-anything-openscreen                     # REPL-Modus
cli-anything-openscreen project new -v recording.mp4 -o projekt.openscreen
cli-anything-openscreen --json project info

REPL-Modus

Führen Sie cli-anything-openscreen ohne Argumente aus, um in den interaktiven Modus zu gelangen. Geben Sie help für verfügbare Befehle und quit zum Beenden ein.

Befehlsgruppen

project

Erstellen, öffnen, speichern und konfigurieren Sie Projekte.

Befehl	Beschreibung
project new [-v VIDEO] [-o PFAD]	Neues Projekt mit optionalem Video erstellen
project open <pfad>	Vorhandenes .openscreen-Projekt öffnen
project save [-o PFAD]	Projekt in Datei speichern
project info	Projektmetadaten und Regionsanzahlen anzeigen
project set-video <pfad>	Quellvideodatei festlegen
project set <schlüssel> <wert>	Editor-Einstellung setzen (Padding, Hintergrund usw.)

zoom

Verwalten Sie Zoomregionen – sanfte Zoomeffekte auf bestimmten Timeline-Bereichen.

Befehl	Beschreibung
zoom list	Alle Zoomregionen auflisten
zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1]	Zoom hinzufügen
zoom remove <id>	Zoomregion entfernen

Zoomtiefen: 1 = 1,25x, 2 = 1,5x, 3 = 1,8x, 4 = 2,2x, 5 = 3,5x, 6 = 5,0x

speed

Verwalten Sie Geschwindigkeitsregionen – beschleunigen Sie Leerlauf, verlangsamen Sie wichtige Momente.

Befehl	Beschreibung
speed list	Alle Geschwindigkeitsregionen auflisten
speed add --start MS --end MS [--speed 0.25-2.0]	Geschwindigkeitsänderung hinzufügen
speed remove <id>	Geschwindigkeitsregion entfernen

Gültige Geschwindigkeiten: 0,25, 0,5, 0,75, 1,25, 1,5, 1,75, 2,0

trim

Verwalten Sie Trimregionen – schneiden Sie Abschnitte der Aufnahme heraus.

Befehl	Beschreibung
trim list	Alle Trimregionen auflisten
trim add --start MS --end MS	Einen Abschnitt herausschneiden
trim remove <id>	Trimregion entfernen

crop

Legen Sie den sichtbaren Bereich der Aufnahme fest.

Befehl	Beschreibung
crop get	Aktuelle Zuschneideregion anzeigen
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1	Zuschneiden festlegen (normalisiert)

annotation

Fügen Sie Textüberlagerungen zur Aufnahme hinzu.

Befehl	Beschreibung
annotation list	Alle Anmerkungen auflisten
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1]	Text hinzufügen
annotation remove <id>	Anmerkung entfernen

media

Untersuchen und validieren Sie Mediendateien.

Befehl	Beschreibung
media probe <pfad>	Video-Metadaten anzeigen (Auflösung, Dauer, Codec)
media check <pfad>	Eine Videodatei validieren
media thumbnail <eingabe> <ausgabe> [-t ZEIT]	Ein Einzelbild extrahieren

export

Rendern Sie das finale polierte Video.

Befehl	Beschreibung
export presets	Verfügbare Export-Voreinstellungen auflisten
export render <ausgabepfad>	Projekt in Videodatei rendern

preview

Erfassen Sie aussagekräftige Review-Bündel aus dem aktuellen Openscreen-Projekt.

Befehl	Beschreibung
preview recipes	Verfügbare Preview-Rezepte auflisten
preview capture --recipe quick	Ein Vorschaubündel mit niedriger Auflösung rendern
preview latest [--recipe quick]	Das neueste vorhandene Bündel zurückgeben

Der aktuelle Preview-Support ist statisch, nicht live. Ein quick-Bündel enthält typischerweise:

• einen Preview-Clip mit niedriger Auflösung
• einzelne Bilder (Frames)
• ein hero-Bild zur schnellen Inspektion
• summary.json mit Informationen zu Trim, Zoom und Geschwindigkeit

Die Bündelerfassung schreibt oder aktualisiert außerdem eine stabile, rezeptabhängige trajectory.json neben dem Preview-Stammverzeichnis, damit Agenten den Preview-Verlauf im Laufe der Zeit rekonstruieren können.

Betrachter-Befehle:

cli-hub previews inspect /pfad/zu/buendel
cli-hub previews html /pfad/zu/buendel -o seite.html
cli-hub previews open /pfad/zu/buendel

session

Verwalten Sie den Sitzungszustand mit Rückgängig/Wiederholen.

Befehl	Beschreibung
session status	Sitzungsinformationen anzeigen
session undo	Letzte Operation rückgängig machen
session redo	Letzte rückgängig gemachte Operation wiederherstellen
session save	Sitzungszustand auf Festplatte speichern
session list	Alle gespeicherten Sitzungen auflisten

Zustandsverwaltung

• Rückgängig/Wiederholen: Bis zu 50 Ebenen des Rückgängig-Verlaufs
• Projektpersistenz: JSON-.openscreen-Dateien
• Sitzungsverfolgung: automatische Nachverfolgung von Änderungen

Ausgabeformate

• Für Menschen lesbar (Standard): Formatierte Schlüssel-Wert-Paare
• Maschinenlesbar (--json): Strukturierte JSON-Ausgabe

Editor-Einstellungen

Einstellung	Typ	Standard	Beschreibung
aspectRatio	string	"16:9"	16:9, 9:16, 1:1, 4:3, 4:5
wallpaper	string	"gradient_dark"	Hintergrundvoreinstellung
padding	int	50	0-100, Abstand um das Video
borderRadius	int	12	Eckenradius in Pixeln
shadowIntensity	float	0	0-1, Stärke des Schlagschattens
motionBlurAmount	float	0	0-1, Bewegungsunschärfe beim Zoom
exportQuality	string	"good"	medium, good, source
exportFormat	string	"mp4"	mp4, gif

Für KI-Agenten

1. Verwenden Sie immer --json für analysierbare Ausgaben
2. Prüfen Sie die Rückgabecodes – 0 = Erfolg, ungleich Null = Fehler
3. Analysieren Sie stderr für Fehlermeldungen im Nicht-JSON-Modus
4. Verwenden Sie absolute Dateipfade
5. Überprüfen Sie nach export render, ob die Ausgabe existiert, und untersuchen Sie sie
6. Zeiten sind in Millisekunden für alle Regionsbefehle
7. Koordinaten (Fokus, Zuschnitt, Position) sind normalisiert 0–1
8. Verwenden Sie preview capture --json, um Zoom, Trimmung, Anmerkungen und Timing visuell zu validieren
9. Lesen Sie die zurückgegebenen Bündel-Artefaktpfade aus dem JSON-Payload; Bilder und Clips liegen auf der Festplatte
10. Verwenden Sie cli-hub previews ... nur zum Inspizieren/Öffnen vorhandener Bündel

Version

1.0.0