What changed
OpenShot 4.1 introduces an experimental `openshot-cli` interface for editing video from a shell. Commands start a session, import media, place and trim clips, apply motion/look/speed presets, create text and keyframes, inspect timeline previews and contact sheets, and export. Commands return JSON, making the interface usable from scripts or coding agents. The release also introduces automatic proxy optimisation for footage that previews slowly, direct text editing, export-setting validation and Linux ARM64 builds through a daily PPA or edge Snap.
Why it matters
Video production is usually a manual GUI workflow or requires building directly on lower-level FFmpeg APIs. OpenShot now exposes the editor's own timeline model as a programmable interface, so small teams can automate repetitive social clips, batch edits and media transformations while retaining a familiar project file and GUI for review. That is a practical workflow change, not evidence that an agent can independently produce reliable finished films.
A scriptable timeline rather than just a batch encoder
`openshot-cli session start`, `file import`, `clip add`, motion presets and `export start --wait` can assemble an edit using the same project semantics as the desktop application. JSON results allow a program to track file and clip IDs and respond to errors. The project explicitly labels the command-line feature experimental.
Headless and desktop editing can share a project
The CLI can run with an open editor or without a display. On desktop, `openshot-cli session show` brings the active session into view with timeline and undo history; a headless server can save an `.osp` project for later GUI editing. This provides a human review point instead of assuming autonomous output is correct.
Agents can inspect frames before choosing edits
The command-line surface offers thumbnails, contact sheets, waveform data and timeline previews. These are ways to provide an agent or script with evidence of what is on the timeline, but no independent quality or reliability benchmark accompanies the release.
Auto-Optimize reduces preview cost, not export resolution
OpenShot measures slow thumbnail decoding and can offer optimised 720p copies of difficult footage for scrubbing and previews. Final exports still read the original full-quality media. Users can choose Ask, Always or Never, and existing projects are checked in the background.
Deployment and compatibility boundaries
OpenShot 4.1 is available for Windows, macOS and Linux. ARM64 Linux builds are described for the daily PPA and edge Snap channels, not a claim of identical stable package availability everywhere. OpenShot specifies openshot-qt 4.1.0, libopenshot 1.1.0 and libopenshot-audio 1.0.2 compatibility.