Cli Anything Obs Studio

by hkuds34f519533bc1No license51K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 weeks ago

Command-line interface for Obs Studio - A stateful command-line interface for OBS Studio scene collection editing, following the same patter...

Instructions onlyDesign & Creative
AI-generated overview

Stateful command-line interface for editing OBS Studio scene collections stored as JSON, with scenes, sources, filters, audio, transitions and outputs.

What it does
Provides a command-line tool and interactive REPL for creating and editing OBS Studio scene collections held in a JSON project file. It manages projects, scenes, sources, filters, global audio, transitions and streaming or recording output settings, with undo/redo history and save/load persistence. Commands support human-readable output by default and structured JSON output via a flag for programmatic use.
When to use it
Use it to build or modify OBS Studio scene collections without opening OBS Studio, including scripting scene, source, filter, audio and transition changes. It suits agent-driven or automated editing of scene collection JSON files.
Requirements
Python 3.10+ and the cli-anything-obs_studio package installed via pip; the document also lists OBS Studio as a prerequisite, though it states no OBS installation is required for editing. Ships no scripts; instructions only.

cli-anything-obs_studio

A stateful command-line interface for OBS Studio scene collection editing, following the same patterns as the Blender CLI harness. Uses a JSON scene collection format. No OBS installation required for editing.

Installation

This CLI is installed as part of the cli-anything-obs_studio package:

bash
pip install cli-anything-obs_studio

Prerequisites:

  • Python 3.10+
  • obs_studio must be installed on your system

Usage

Basic Commands

bash
# Show helpcli-anything-obs_studio --help
# Start interactive REPL modecli-anything-obs_studio
# Create a new projectcli-anything-obs_studio project new -o project.json
# Run with JSON output (for agent consumption)cli-anything-obs_studio --json project info -p project.json

REPL Mode

When invoked without a subcommand, the CLI enters an interactive REPL session:

bash
cli-anything-obs_studio# Enter commands interactively with tab-completion and history

Command Groups

Project

Project management commands.

CommandDescription
newCreate a new OBS scene collection
openOpen an existing project
saveSave the current project
infoShow project information
jsonPrint raw project JSON

Scene Group

Scene management commands.

CommandDescription
addAdd a new scene
removeRemove a scene by index
duplicateDuplicate a scene
set-activeSet the active scene
listList all scenes

Source Group

Source management commands.

CommandDescription
addAdd a source to a scene
removeRemove a source by index
duplicateDuplicate a source
setSet a source property (name, visible, locked, opacity, rotation)
transformTransform a source (position, size, crop, rotation)
listList all sources in a scene

Filter Group

Filter management commands.

CommandDescription
addAdd a filter to a source
removeRemove a filter from a source
setSet a filter parameter
listList all filters on a source
list-availableList all available filter types

Audio Group

Audio management commands.

CommandDescription
addAdd a global audio source
removeRemove a global audio source
volumeSet volume for an audio source (0.0-3.0)
muteMute an audio source
unmuteUnmute an audio source
monitorSet audio monitoring type
listList all audio sources

Transition Group

Transition management commands.

CommandDescription
addAdd a transition
removeRemove a transition
set-activeSet the active transition
durationSet transition duration in milliseconds
listList all transitions

Output Group

Output/streaming/recording configuration.

CommandDescription
streamingConfigure streaming settings
recordingConfigure recording settings
settingsConfigure output settings
infoShow current output configuration
presetsList available encoding presets

Session

Session management commands.

CommandDescription
statusShow session status
undoUndo the last operation
redoRedo the last undone operation
historyShow undo history

Examples

Create a New Project

Create a new obs_studio project file.

bash
cli-anything-obs_studio project new -o myproject.json# Or with JSON output for programmatic usecli-anything-obs_studio --json project new -o myproject.json

Interactive REPL Session

Start an interactive session with undo/redo support.

bash
cli-anything-obs_studio# Enter commands interactively# Use 'help' to see available commands# Use 'undo' and 'redo' for history navigation

State Management

The CLI maintains session state with:

  • Undo/Redo: Up to 50 levels of history
  • Project persistence: Save/load project state as JSON
  • Session tracking: Track modifications and changes

Output Formats

All commands support dual output modes:

  • Human-readable (default): Tables, colors, formatted text
  • Machine-readable (--json flag): Structured JSON for agent consumption
bash
# Human outputcli-anything-obs_studio project info -p project.json
# JSON output for agentscli-anything-obs_studio --json project info -p project.json

For AI Agents

When using this CLI programmatically:

  1. Always use --json flag for parseable output
  2. Check return codes - 0 for success, non-zero for errors
  3. Parse stderr for error messages on failure
  4. Use absolute paths for all file operations
  5. Verify outputs exist after export operations

More Information

  • Full documentation: See README.md in the package
  • Test coverage: See TEST.md in the package
  • Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-obs-studioat commit34f5195

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from hkuds/cli-anything

Cli Anything Zoom

hkuds

Command-line harness for managing Zoom meetings, participants, and cloud recordings through the Zoom REST API.

Productivity & Workflow51Kupdated 2 weeks ago

Cli Anything Novita

hkuds

Documents a command-line client for the Novita AI API, offering chat, streaming, model listing, session and config commands.

Software Development51Kupdated 2 weeks ago

Cli Anything Zotero

hkuds

Agent-native CLI harness for inspecting and operating a local Zotero desktop library.

Research & Analysis51Kupdated 2 weeks ago

Cli Anything Wiremock

hkuds

CLI harness for administering a WireMock HTTP mock server via its Admin REST API.

Software Development51Kupdated 2 weeks ago

Cli Anything Slay The Spire Ii

hkuds

Controls the Slay the Spire 2 game through a local bridge mod HTTP API, reading state and sending actions.

Other51Kupdated 2 weeks ago

Cli Anything Shotcut

hkuds

Command-line interface for creating and editing Shotcut video projects and rendering them without a GUI.

Design & Creative51Kupdated 2 weeks ago

More in Design & Creative

Theme Factory

anthropics

Featured

Offers 10 preset color-and-font themes, plus custom theme generation, for styling slide decks, documents, reports and HTML pages.

Design & Creative179Kupdated today

Slack Gif Creator

anthropics

Featured

Creates animated GIFs sized and optimized for Slack, with PIL drawing helpers, easing and validation utilities.

Includes scripts
Design & Creative179Kupdated today

Frontend Design

anthropics

Featured

Guidance for distinctive, intentional visual design when building or reshaping a user interface.

Design & Creative179Kupdated today

Canvas Design

anthropics

Featured

Creates original visual art as PNG or PDF from a written design philosophy, for posters, artworks and other static pieces.

Design & Creative179Kupdated today

Brand Guidelines

anthropics

Featured

Applies Anthropic's official brand colors and typography to artifacts that should carry the Anthropic look-and-feel.

Design & Creative179Kupdated today

Frontend Design

anthropics

Featured

Guides an agent through distinctive, intentional visual design for new or redesigned user interfaces.

Design & Creative149Kupdated today