Cli Anything Openscreen

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

Command-line interface for Openscreen — a screen recording editor. A stateful CLI for editing screen recordings with zoom, speed ramps, trim, crop, annotations, and polished exports. Built on the Openscreen JSON project format with ffmpeg as the rendering backend. Designed for AI agents and power users who need programmatic video editing.

Instructions only

cli-anything-openscreen

A stateful command-line interface for editing screen recordings. Transform raw captures into polished demo videos with zoom effects, speed adjustments, trimming, annotations, and beautiful backgrounds.

Installation

bash
pip install cli-anything-openscreen

Prerequisites:

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

Usage

Basic Commands

bash
cli-anything-openscreen --helpcli-anything-openscreen                     # REPL modecli-anything-openscreen project new -v recording.mp4 -o project.openscreencli-anything-openscreen --json project info

REPL Mode

Run cli-anything-openscreen without arguments to enter interactive mode. Type help for available commands, quit to exit.

Command Groups

project

Create, open, save, and configure projects.

CommandDescription
project new [-v VIDEO] [-o PATH]Create new project with optional video
project open <path>Open existing .openscreen project
project save [-o PATH]Save project to file
project infoShow project metadata and region counts
project set-video <path>Set source video file
project set <key> <value>Set editor setting (padding, wallpaper, etc.)

zoom

Manage zoom regions — smooth zoom effects on specific timeline areas.

CommandDescription
zoom listList all zoom regions
zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1]Add zoom
zoom remove <id>Remove zoom region

Zoom depths: 1=1.25x, 2=1.5x, 3=1.8x, 4=2.2x, 5=3.5x, 6=5.0x

speed

Manage speed regions — speed up idle time, slow down important moments.

CommandDescription
speed listList all speed regions
speed add --start MS --end MS [--speed 0.25-2.0]Add speed change
speed remove <id>Remove speed region

Valid speeds: 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, 2.0

trim

Manage trim regions — cut out sections of the recording.

CommandDescription
trim listList all trim regions
trim add --start MS --end MSCut out a section
trim remove <id>Remove trim region

crop

Set the visible area of the recording.

CommandDescription
crop getShow current crop region
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1Set crop (normalized)

annotation

Add text overlays to the recording.

CommandDescription
annotation listList all annotations
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1]Add text
annotation remove <id>Remove annotation

media

Inspect and validate media files.

CommandDescription
media probe <path>Show video metadata (resolution, duration, codec)
media check <path>Validate a video file
media thumbnail <input> <output> [-t TIME]Extract a frame

export

Render the final polished video.

CommandDescription
export presetsList available export presets
export render <output_path>Render project to video file

preview

Capture truthful review bundles from the current Openscreen project.

CommandDescription
preview recipesList available preview recipes
preview capture --recipe quickRender a low-res preview bundle
preview latest [--recipe quick]Return the latest existing bundle

Current preview support is static rather than live. A quick bundle typically contains:

  • a low-res preview clip
  • sampled frames
  • a hero frame for quick inspection
  • summary.json with trim/zoom/speed facts

Bundle capture also writes or updates a stable recipe-level trajectory.json beside the preview root so agents can reconstruct preview history over time.

Viewer commands:

bash
cli-hub previews inspect /path/to/bundlecli-hub previews html /path/to/bundle -o page.htmlcli-hub previews open /path/to/bundle

session

Manage session state with undo/redo.

CommandDescription
session statusShow session info
session undoUndo last operation
session redoRedo last undone operation
session saveSave session state to disk
session listList all saved sessions

State Management

  • Undo/Redo: Up to 50 levels of undo history
  • Project persistence: JSON .openscreen files
  • Session tracking: auto-tracks modifications

Output Formats

  • Human-readable (default): Formatted key-value pairs
  • Machine-readable (--json): Structured JSON output

Editor Settings

SettingTypeDefaultDescription
aspectRatiostring"16:9"16:9, 9:16, 1:1, 4:3, 4:5
wallpaperstring"gradient_dark"Background preset
paddingint500-100, padding around video
borderRadiusint12Corner radius in pixels
shadowIntensityfloat00-1, drop shadow strength
motionBlurAmountfloat00-1, motion blur during zoom
exportQualitystring"good"medium, good, source
exportFormatstring"mp4"mp4, gif

For AI Agents

  1. Always use --json for parseable output
  2. Check return codes — 0 = success, non-zero = error
  3. Parse stderr for error messages in non-JSON mode
  4. Use absolute file paths
  5. After export render, verify the output exists and probe it
  6. Times are in milliseconds for all region commands
  7. Coordinates (focus, crop, position) are normalized 0-1
  8. Use preview capture --json to validate zoom, trim, annotation, and timing visually
  9. Read returned bundle artifact paths from the JSON payload; images and clips live on disk
  10. Use cli-hub previews ... only to inspect/open existing bundles

Version

1.0.0

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-openscreenat 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