cli-anything-obs_studio
Eine zustandsbehaftete Befehlszeilenschnittstelle zur Bearbeitung von OBS Studio Szenensammlungen, die denselben Mustern wie das Blender CLI-Harness folgt. Verwendet ein JSON-Format für Szenensammlungen. Für die Bearbeitung ist keine OBS-Installation erforderlich.
Installation
Diese CLI wird als Teil des cli-anything-obs_studio-Pakets installiert:
pip install cli-anything-obs_studio
Voraussetzungen:
- Python 3.10+
- obs_studio muss auf Ihrem System installiert sein
Verwendung
Grundlegende Befehle
# Hilfe anzeigen
cli-anything-obs_studio --help
# Interaktiven REPL-Modus starten
cli-anything-obs_studio
# Ein neues Projekt erstellen
cli-anything-obs_studio project new -o project.json
# Mit JSON-Ausgabe ausführen (für Agenten)
cli-anything-obs_studio --json project info -p project.json
REPL-Modus
Wenn ohne Unterbefehl aufgerufen, startet die CLI eine interaktive REPL-Sitzung:
cli-anything-obs_studio
# Befehle interaktiv eingeben mit Tab-Vervollständigung und Verlauf
Befehlsgruppen
Projekt
Projektverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
new | Eine neue OBS Szenensammlung erstellen |
open | Ein vorhandenes Projekt öffnen |
save | Das aktuelle Projekt speichern |
info | Projektinformationen anzeigen |
json | Rohprojekt-JSON ausgeben |
Szenengruppe
Szenenverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
add | Eine neue Szene hinzufügen |
remove | Eine Szene nach Index entfernen |
duplicate | Eine Szene duplizieren |
set-active | Die aktive Szene festlegen |
list | Alle Szenen auflisten |
Quellgruppe
Quellenverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
add | Eine Quelle zu einer Szene hinzufügen |
remove | Eine Quelle nach Index entfernen |
duplicate | Eine Quelle duplizieren |
set | Eine Quelleneigenschaft festlegen (Name, Sichtbar, Gesperrt, Deckkraft, Rotation) |
transform | Eine Quelle transformieren (Position, Größe, Zuschnitt, Rotation) |
list | Alle Quellen in einer Szene auflisten |
Filtergruppe
Filterverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
add | Einen Filter zu einer Quelle hinzufügen |
remove | Einen Filter von einer Quelle entfernen |
set | Einen Filterparameter festlegen |
list | Alle Filter auf einer Quelle auflisten |
list-available | Alle verfügbaren Filtertypen auflisten |
Audiogruppe
Audioverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
add | Eine globale Audioquelle hinzufügen |
remove | Eine globale Audioquelle entfernen |
volume | Lautstärke für eine Audioquelle festlegen (0.0-3.0) |
mute | Eine Audioquelle stummschalten |
unmute | Stummschaltung einer Audioquelle aufheben |
monitor | Audioüberwachungstyp festlegen |
list | Alle Audioquellen auflisten |
Übergangsgruppe
Übergangsverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
add | Einen Übergang hinzufügen |
remove | Einen Übergang entfernen |
set-active | Den aktiven Übergang festlegen |
duration | Übergangsdauer in Millisekunden festlegen |
list | Alle Übergänge auflisten |
Ausgabegruppe
Ausgabe-/Streaming-/Aufzeichnungskonfiguration.
| Befehl | Beschreibung |
|---|---|
streaming | Streaming-Einstellungen konfigurieren |
recording | Aufzeichnungseinstellungen konfigurieren |
settings | Ausgabeeinstellungen konfigurieren |
info | Aktuelle Ausgabekonfiguration anzeigen |
presets | Verfügbare Kodierungsvoreinstellungen auflisten |
Sitzung
Sitzungsverwaltungsbefehle.
| Befehl | Beschreibung |
|---|---|
status | Sitzungsstatus anzeigen |
undo | Die letzte Operation rückgängig machen |
redo | Die letzte rückgängig gemachte Operation wiederholen |
history | Rückgängig-Verlauf anzeigen |
Beispiele
Ein neues Projekt erstellen
Erstellen Sie eine neue obs_studio-Projektdatei.
cli-anything-obs_studio project new -o myproject.json
# Oder mit JSON-Ausgabe für programmatische Nutzung
cli-anything-obs_studio --json project new -o myproject.json
Interaktive REPL-Sitzung
Starten Sie eine interaktive Sitzung mit Undo/Redo-Unterstützung.
cli-anything-obs_studio
# Befehle interaktiv eingeben
# 'help' verwenden, um verfügbare Befehle anzuzeigen
# 'undo' und 'redo' für die Verlaufsnavigation verwenden
Zustandsverwaltung
Die CLI verwaltet den Sitzungszustand mit:
- Undo/Redo: Bis zu 50 Stufen Verlauf
- Projektpersistenz: Projektzustand als JSON speichern/laden
- Sitzungsverfolgung: Änderungen und Modifikationen verfolgen
Ausgabeformate
Alle Befehle unterstützen zwei Ausgabemodi:
- Menschenlesbar (Standard): Tabellen, Farben, formatierter Text
- Maschinenlesbar (
--json-Flag): Strukturiertes JSON für Agenten-Nutzung
# Ausgabe für Menschen
cli-anything-obs_studio project info -p project.json
# JSON-Ausgabe für Agenten
cli-anything-obs_studio --json project info -p project.json
Für KI-Agenten
Bei programmatischer Verwendung dieser CLI:
- Immer das
--json-Flag verwenden für analysierbare Ausgabe - Rückgabecodes prüfen - 0 für Erfolg, ungleich 0 für Fehler
- stderr parsen für Fehlermeldungen bei Misserfolg
- 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