Can I undo changes made via the CLI?

Yes, the CLI maintains a session history with up to 50 levels of undo and redo functionality for all project operations.

Do I need OBS Studio installed to use this?

Yes, OBS Studio must be installed on your system as a prerequisite, but the CLI allows you to edit scene collection files without the application currently running.

Does it support streaming and recording settings?

Yes, the Output Group commands allow you to configure streaming settings, recording paths, and encoder presets programmatically.

What parameters can I control for sources?

You can modify source properties such as visibility, name, locked status, opacity, and rotation, as well as complex transforms like position, size, and cropping.

How does this help AI agents like Claude?

The CLI includes a --json flag that provides structured data, making it easy for AI agents to parse the current state, verify changes, and execute precise layout commands.

OBS Studio CLI Harness

Name: OBS Studio CLI Harness
Author: hazelugo

byhazelugo

0•

Productivity & Workflow

Manages OBS Studio scene collections and configurations through a stateful command-line interface designed for human and AI agent use.

This skill provides a comprehensive CLI for editing OBS Studio scene collections without requiring the OBS application to be open during the editing process. It offers a stateful environment with full undo/redo history, allowing users or AI agents to programmatically manipulate scenes, sources, filters, audio settings, and output configurations. By utilizing a standardized JSON format and providing machine-readable outputs, it enables the seamless automation of broadcast layouts, streaming setups, and complex video production workflows directly from the terminal or through Claude Code.

Key Features

01Complete project persistence allowing edits without an active OBS installation

02Machine-readable JSON output mode specifically optimized for AI agents

03Interactive REPL mode with tab-completion for manual configuration

04Granular control over scenes, sources, filters, and audio parameters

05Stateful scene collection editing with 50 levels of undo/redo history

060 GitHub stars

Use Cases

01Programmatic adjustment of source transforms and filters via scripts or AI

02Version-controlling OBS configurations by managing them as JSON project files

03Automating the creation of complex OBS scene layouts for scheduled broadcasts

Key Features

01Complete project persistence allowing edits without an active OBS installation

02Machine-readable JSON output mode specifically optimized for AI agents

03Interactive REPL mode with tab-completion for manual configuration

04Granular control over scenes, sources, filters, and audio parameters

05Stateful scene collection editing with 50 levels of undo/redo history

060 GitHub stars

Use Cases

01Programmatic adjustment of source transforms and filters via scripts or AI

02Version-controlling OBS configurations by managing them as JSON project files

03Automating the creation of complex OBS scene layouts for scheduled broadcasts