Video Editor Overview

A chat-driven, LLM-integrated video editor — every frame composited locally on your PC.

What can you do?

The Video Editor lives inside the Bom Agent desktop app. Type "trim the first 3 seconds" into the chat panel and the LLM generates a timeline JSON patch; FFmpeg and whisper.cpp handle the actual rendering.

  • LLM-driven editing (Claude Code · Codex)
  • Multi-track timeline (video · audio · subtitle)
  • 40+ xfade transitions plus custom GLSL shaders
  • Auto-ducking — voice detection lowers BGM automatically
  • Real-time WebGL preview (toggleable to DOM mode)
  • Export presets for YouTube / Reels / X, or fully custom encodes
Note

Composition happens on your machine. Source clips never leave your folders unless you opt-in.

How it works at a glance

Here is the data flow from your chat to the rendered preview.

  1. Type a natural-language command into the Bom.Ag chat.
  2. The Worker calls the bom-av MCP to compute a JSON diff and writes it to ~/.bom/timelines/<project>.json.
  3. TimelineService (FileSystemWatcher) detects the change and pushes through SignalR `/editor` to the browser UI.
  4. The WebGL preview updates instantly; you Apply or Undo.
Tip

You can edit ~/.bom/timelines/*.json with any external editor — the change appears in the editor as soon as you save.

Free vs paid

The Video Editor is included in the free Bom Agent plan. There is no per-render fee and your existing CLI subscriptions (Claude Pro, ChatGPT Plus) are reused.

  • Free: all editor features + unlimited local renders
  • CLI cost: whatever your subscription already covers — Bom never adds a charge

Next steps

Walk through these pages in order to ship a polished cut in 30 minutes.

  • Getting started — open the editor, first project
  • Timeline — tracks, clips, keyframes
  • Auto-ducking — make narration crisp
  • Export — YouTube / Reels presets