studio_finish
Finish screen recordings by producing MP4, GIF, and social crops with optional offline voiceover, music, and subtitles - all local, no API keys.
Instructions
Stop recording and produce the final files: closes the browser, strips residual dark frames (ffmpeg blackdetect → trim), transcodes to a share-ready MP4 (H.264, faststart), then — optionally — narrates the caption lines with a LOCAL voice (no cloud/keys), lays down a music bed, writes/burns subtitles, and exports vertical/square social crops, plus a GIF. Voice-over timing is auto-corrected for the frames the deblack step removed. Returns every produced file with size + duration. Without ffmpeg you still get the raw WebM.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gif | No | Also export a compact GIF (optional; default false). | |
| name | Yes | Base file name for the video (without extension), e.g. 'onboarding-walkthrough'. | |
| music | No | Path to a local audio file for a background music bed, looped and ducked under the voice-over (optional). | |
| voice | No | System voice name (optional), e.g. macOS 'Samantha' or 'Daniel'; falls back to the OS default voice. | |
| aspects | No | Extra social crops to export beside the 16:9 master, e.g. ['9:16','1:1'] for Reels/TikTok/feed. Padded with the theme background. | |
| subtitles | No | 'srt' writes a sidecar .srt from the caption lines; 'burn' also renders them into the picture (muted-autoplay social); 'none' (default). | |
| voiceover | No | Narrate the caption / studio_narrate lines with a local, offline voice (macOS say · piper · espeak-ng). No account, no API key. Default false. |