Captions burned into a video
caption_videoBurns captions or subtitles into a video from word-timed JSON, SRT or WebVTT files, in karaoke, line or word style, kept clear of app buttons.
Instructions
Use it when the user wants captions or subtitles burned into a video, to read with the sound off, karaoke style or in the brand's fonts, clear of an app's buttons. Burns captions into a video from words with times the user already has: a speech-to-text JSON with word or line times, from OpenAI, whisper.cpp, Deepgram and others, an SRT or WebVTT file, or a demo's steps file, whose step notes become the captions. It does not listen, and no tool here makes such a file. karaoke shows each caption whole and lights the word being spoken, line shows whole captions, word one word at a time. The captions sit inside the space every place in for leaves free of its buttons, drawn by Chrome on this machine in the fonts and color given and laid over the video in one ffmpeg encode, its sound copied. Writes captioned.mp4, captions.srt, captions.vtt, captions.ass, words.json, sheet.png (captions on their frames, the picture to look at first), safe-zones.png (a frame under each app's buttons) and CAPTIONS.md, which the result shows. For the subtitle files alone, use make_subtitles instead. The captions playbook (makersmcp_playbook) has the whole job. (easycaptionkit 0.1.4, on this machine.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video": "<video>",
"words": "<words>"
},
"name": "caption_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| box | No | A dark box behind the words instead of an outline. | |
| for | No | The places the video goes to: the captions keep clear of the buttons of every one of them at once (default: the places of the video's shape). | |
| font | No | A font family to draw with, from fonts.css or this machine, like Inter. | |
| size | No | The letters' size in percent of a phone's width, or of the frame's short side, 2 to 20 (default 6.5, or 9.5 for the word style). A line too wide for the free space is drawn smaller. | |
| brand | No | A brand kit, its folder or brand.json: its button, link or logo color lights the spoken word, and without fonts or font its heading font is asked for by name, which this machine may not have. make_brand_kit makes one. | |
| fonts | No | A font kit, its folder or fonts.css: the captions are drawn with the site's own font files, its heading font first. make_font_kit makes one. | |
| lines | No | Lines a caption may take, 1 to 3 (default 2); the word style shows one. | |
| style | No | karaoke lights the word being spoken in each whole caption (default karaoke), line shows whole captions in one color, word one word at a time, bigger. | |
| video | Yes | The video to caption, any file ffmpeg reads. A launch film's film.timeline.json beside it is copied as captioned.timeline.json, so check_video finds its cuts. | |
| words | Yes | The words and their times: a speech-to-text JSON, an SRT or WebVTT file, a demo's steps.json, or the words.json of an earlier run with a misheard word fixed by hand. Not an ASS file. | |
| libass | No | Draw the captions with ffmpeg's libass instead of Chrome, for a machine where Chrome cannot start; it needs an ffmpeg built with libass and draws no color emoji. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: <video-folder>/easycaptionkit-<video-name>, where <video-name> is the name of video without its extension and <video-folder> is the folder video is in. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. | |
| position | No | Where in the free space the captions sit (default bottom): middle or top when the picture has text or a face at the bottom of it. | |
| highlight | No | The spoken word's color, like #ffd23f, in the karaoke and word styles; a dark one lights the word on a patch of it. | |
| max_chars | No | Characters a line may take, 8 to 80 (default: what fits the safe width, at most 42). | |
| wait_seconds | No | How long to wait for the result, counted from the start of the call, before returning a job_id to wait on. Some clients end a call after 60 or 240 seconds; 45 is safe in all of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| docs | No | The notes the text shows, and where each one is. | |
| next | No | What to do next, as the Next line says. | |
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| continued | No | True when this call continued the job of an identical call whose answer did not reach the client, instead of starting another. | |
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |