Open a URL in a browser and start recording video. Returns a session ID. Call stop_recording when done.

Instead of specifying width/height, you can use the "platform" parameter:

• "Record my app for GitHub README" → platform: "github" (1280×720, GIF)

• "Record my app for Instagram Reels" → platform: "reels" (1080×1920, MP4)

• "Record my app for TikTok" → platform: "tiktok" (1080×1920, MP4)

• "Record my app for YouTube" → platform: "youtube" (1280×720, MP4)

• "Record my app for YouTube Shorts" → platform: "shorts" (1080×1920, MP4)

• "Record my app for Instagram post" → platform: "instagram" (1080×1080, MP4)

• "Record my app for LinkedIn" → platform: "linkedin" (1080×1080, MP4)

• "Record my app for Twitter" → platform: "twitter" (1280×720, MP4)

Or pass custom width/height for any other size.

Perform actions on a recording page (scroll, click, hover, type, press, select, wait, navigate). Actions are performed sequentially and recorded in the video.

Stop a recording session and save the video as .webm file.

Convert a .webm video to an optimized GIF using ffmpeg two-pass palette method.

Convert a .webm video to MP4 (H.264). Widely compatible for social media, sharing, and embedding.

All-in-one: open URL, wait for specified duration, stop recording, auto-export to the right format.

Use the "platform" parameter and we handle everything:

• "Record a demo for my GitHub README" → platform: "github" → 1280×720 GIF

• "Record my app for Instagram Reels" → platform: "reels" → 1080×1920 MP4

• "Make a TikTok demo" → platform: "tiktok" → 1080×1920 MP4

• "Record for YouTube" → platform: "youtube" → 1280×720 MP4

Or pass custom width/height/outputFormat for full control.

List all .webm and .gif recordings in the output directory.

Convert a recorded .webm to GIF or MP4 with cinematic crop-pan effects.

Crops the entire frame to focus on the interaction area, then pans smoothly between targets. Think of it as a virtual cameraman that follows the action.

Two rendering modes:

• "quick" (default): FFmpeg-based crop with smoothstep easing. Fast, no extra dependencies.

• "cinematic": Remotion-based rendering with spring animations. Requires remotion + react installed.

Example workflow:

1. record_page → interact_page (clicks, typing, etc.) → stop_recording

2. cinematic_export with the webmPath and timelinePath from stop_recording

3. Get a polished GIF/MP4 where the camera follows the action

Convert a recorded .webm to GIF or MP4 with tooltip overlays on interactions.

The full viewport stays visible. When an interaction happens (click, type, hover), a clean tooltip inset appears showing a magnified close-up of that area with a small arrow pointing toward the interaction. Modern, minimal design (Linear/Figma style).

The tooltip positions itself on the opposite side of the screen from the interaction.

Perfect for product demos where viewers need to see both the full UI context AND the detail.

Example workflow:

1. record_page → interact_page (clicks, typing, etc.) → stop_recording

2. smart_export with the webmPath and timelinePath from stop_recording

3. Get a polished GIF/MP4 with tooltip overlays on every interaction

Compare with cinematic_export which crops the entire frame to follow the action.