Blazing Video

Cut every um/uh-style filler word (one undo step).

Cut source-clock time ranges (ms) from the edit — one undoable step in the app. Optionally cut whole words by index (uses the same word-boundary padding as deleting in the transcript). Set restore=true to un-cut the ranges instead.

Export the edit to an MP4 in ~/Movies (hardware encode). Returns the path and how long it took. Blocks until done.

PNG of the edited video at timeMs on the EDITED clock (after cuts), with the face circle composited.

The open take's words with index, text, source startMs/endMs and whether each is cut (trimmed words count as cut), plus the keep ranges, current cuts, the trim and durations.

Open a take in the editor by path: a take's <base>.mov (or any sidecar), or ANY video file (.mp4/.mov/.m4v — a download, a screen recording from another app), which is imported as a take (an instant APFS clone in the Recordings folder, not a copy) and transcribed on device first (~3 s for 5 min), so get_transcript / cut_ranges / get_frame / export / share work on it. Fails if the path can't be opened. Without a path, opens the newest take. To read what a video says and shows, use understand_video instead.

Whether the recorder is idle, starting, ready or recording, how long the current take has been rolling, and the last finished take.

The studio look: the screen recording inset on a soft gradient wallpaper with rounded corners and a soft shadow; the webcam stays on top (its corners snap inside the screen). Non-destructive; applies to the preview, get_frame, export and share, and becomes the default look for new takes. Omit a field to keep it. enabled:false goes back to the plain full-frame recording. wallpaper: dusk, ocean, aurora, mint, peach, snow or graphite (picking one turns it on). padding: space around the screen as a fraction of the frame's shorter edge, 0–0.2 (default 0.07). roundness and shadow: 0–1. Returns the look.

Change how the webcam sits on the screen recording (the two are separate tracks, so this is non-destructive and applies to the preview, get_frame, export and share). Omit a field to keep it. position: a corner (top-left, top-right, bottom-left, bottom-right) or x/y (0–1, centre of the camera, top-left origin). size: fraction of the frame's shorter edge (0.12–0.6; default 0.26). shape: circle, rounded or square (a circle that isn't square is a pill). aspect: the box's width:height — 1:1, 4:3, 3:4 (portrait) or 16:9. zoom: crop into the camera, 1–3. panX/panY: which part of the camera shows when cropped, -1…1 (left…right, top…bottom; 0 = centred). visible:false hides the camera. removeBackground:true cuts the person out of their background (on-device). Returns the layout.

Get a share link for the current edit (on the user's Cloudflare). The link is created and copied to the clipboard at once; the video exports and uploads behind it (the page shows progress, then plays). If the take was shared before, this updates the SAME link with the current edit. wait:true returns only once the link plays.

Start recording the user's screen, camera and microphone (a small island appears at the bottom of their screen). Returns once it is actually rolling — or, if the camera can't start, with a cameraWarning and NOT recording: tell the user why and call again (camera:false records without it). Tell the user to talk and to stop with ⌥⇧R or the island's Stop; then call wait_for_take so you get the take the moment it ends (or stop_recording if they ask you to stop it).

Stop the recording. Returns the take and its transcript and opens it in the editor, ready for get_transcript / cut_ranges / cut_fillers / tighten_pauses / get_frame / export.

Trim every pause over 0.4 s between kept words down to 0.15 s (one undo step).

Trim the head and/or tail of the take — where the edit starts and ends — as one undoable step (like dragging the timeline's end handles). Give startMs/endMs on the SOURCE clock (same as word startMs/endMs; they snap to the nearest word boundary with the usual cut padding unless exact:true), or startWord/endWord: the first/last word index to keep. Omit a side to leave it as it is; clear:true removes the trim. Cuts inside the trimmed parts are kept, so clearing brings back the take as it was edited.

Read a whole video in one call: when the user hands you a video or audio file (a feedback walkthrough, a bug repro, a demo, a meeting) or asks what a take says or shows. Returns its duration, resolution, a timestamped transcript in sentence lines (on-device Parakeet, a 5 min video in a few seconds) and up to maxFrames key frames where the picture changes, as images marked into the transcript (▣n) so you can tie what was said to what was on screen. A video file that isn't a take is imported (instant clone, transcript cached for next time) and opened in the editor, so get_frame for a closer look at any moment, cut_ranges, export and share then work on it. Without a path, reads the take open in the editor (e.g. right after stop_recording). Audio files get the transcript only.

Undo the last edit.

Wait until the take that's rolling stops — by ⌥⇧R, the island's Stop or stop_recording — and return it the way stop_recording does: opened in the editor, with its transcript and share link. Call it right after start_recording so you have the take the moment it ends. If it's still rolling at the timeout it says so; call it again. With nothing rolling it returns the last take.