List CapCut draft folders in the drafts root (read only).

Read one draft and return canvas, fps, duration, which file holds the timeline, and every track/segment in seconds (read only).

Create a new empty draft folder. Default canvas 1080x1920 (vertical short), 30 fps. Copies version markers from an empty CapCut-made project (template_draft, default auto) so CapCut 9.x accepts it. Dry-run by default.

Add a video, image or audio file to a draft timeline. The file is copied into /assets/. Length and size are read from MP4/MOV/M4A/WAV files. Optional fade_in_s / fade_out_s use the same audio-fade writer as capcut_set_clip (video clips also copy audio_fade onto the video material). Times are seconds. Dry-run by default.

Add music or a voice-over (audio file) on an audio track, with volume and optional fade in/out. Default track "music". Dry-run by default.

Add a text overlay (title, hook, CTA) to a draft. Position x/y is -1..1 from the canvas centre. Dry-run by default.

Import an SRT file (or SRT text) as caption text segments on one track. Optional re-chunking into short cards (max_words / max_chars, time shared by letters or words on the frame grid), ALL CAPS and punch words on their own card. x is -1..1 from the canvas centre (default 0, centred), same as capcut_add_text. Dry-run by default.

One call for a vertical short: clip + optional title (title_y, title_color, title_style) + optional SRT subtitles (sub_font_size, sub_color, sub_y, re-chunking, sub_style) + optional background music (with fades). sub_style and title_style use the same fields and writer as capcut_style_text. Give draft (an EMPTY project you made in CapCut: it is filled in place, best for CapCut 9.x) or name (a new draft that copies a CapCut-made project's markers). Dry-run by default.

Change canvas size, fps, total duration or colour space (SDR/HDR) of a draft. Duration cannot cut existing segments. Dry-run by default.

Validate a draft and copy its folder into CAPCUT_EXPORT_ROOT (the CapCut drafts folder) so you can open it in CapCut. Never overwrites. Not needed when CAPCUT_DRAFTS_ROOT already is the CapCut folder. Dry-run by default.

Style text already on a track (captions, titles): WordArt preset, stroke, shadow, background box, per-word highlight color, font file, bold/italic, size, color, wrap width, alignment. All segments on the track, or only the one at start_s. Dry-run by default.

Group the segments that lie fully inside start_s..end_s on one video track into a compound clip (Crear clip combinado), like Option+G in CapCut. Dry-run by default.

Insert one of CapCut's saved elements (right-click > Guardar elemento predefinido; Tuyos > Mis elementos predefinidos) as a compound clip at start_s. Reads the local preset store (CAPCUT_PRESETS_ROOT, default the CapCut Mac container). Dry-run by default.

Copy a text template (Texto > Plantilla de texto) that CapCut already placed in a draft to a new time, in the same or another draft, with fresh ids and optionally new text. Dry-run by default.

Change one clip (the segment at start_s on a track): video scale/position/rotation/opacity, canvas background (color or blur), blend mode, basic adjust, speed (constant), audio volume, fades and noise reduction, stabilization level, audio channel copy, shape mask, flip, crop, curves, color wheels (Pro), HSL (8 colours), voice filter (Pro). Dry-run by default.

Animate one property of the segment at start_s: position_x/position_y (1 = half the canvas), scale (1 = 100%), rotation (degrees), alpha (0-1), volume (1 = original), brightness/contrast/saturation (-1..1). Easing linear (default), in, out or in_out (CapCut's Aceleracion / Desaceleracion / both). Replaces that property's keyframes. Dry-run by default.

Lower the music under speech: reads SRT cues and writes volume keyframes on every segment of the music track (under = level during speech, free = level between lines, default the segment volume). Dry-run by default.

Write the cues of one text track (default subtitles) as an .srt file, e.g. for YouTube closed captions. Never overwrites. Dry-run by default.

Read timeline markers (time_marks from capcut_add_markers) and return a YouTube chapter list: HH:MM:SS Title. Times snap to the draft fps; the stamp is the second that contains that frame. Inserts 00:00:00 when no marker falls in the first second. Refuses a list YouTube will not use: fewer than 3 chapters, displayed times under 10 seconds apart (two markers in the same second count), or a last chapter shorter than 10 seconds against the draft duration. Optional out_path writes a .txt file and never overwrites. Dry-run by default when out_path is set.

Add or refresh this draft in CapCut's project list (root_meta_info.json, backed up first) with its current duration. Run after the last edit. CapCut must be closed. Dry-run by default.

Add (or replace) a transition on the cut after the video segment at start_s, by CapCut resource_id (e.g. 6724845717472416269 = Combinar, free). Duration up to half the shorter clip. Dry-run by default.

Speed curve on one video clip (the segment at start_s): a CapCut preset (montage, hero, bullet, jump_cut, flash_in, flash_out) or custom points [[x 0..1, speed 0.1..10], ...]; null goes back to 1x. Clip length = source / CapCut's average speed, snapped to frames. The Curva tab is marked Pro in CapCut 9.5 (cache ids are free); exporting may need Pro. Dry-run by default.

Put a CapCut filter on one video clip (the segment at start_s) by resource_id, intensity 0-100 (e.g. 7668224318974823701 = Rollo vintage, free). Replaces the clip's filter. Dry-run by default.

Add an in / out / loop (text, sticker) / group (combo) animation to the segment at start_s by resource_id (e.g. video in 6740868384637850120 = Zoom 1, text in 7210980292243231233 = Maquina de escribir). Dry-run by default.

Add a CapCut sticker on a sticker track by resource_id (sticker_id), with position/scale/rotation. The sticker must have been added once in CapCut so it is in Cache/artistEffect. Animate it with capcut_add_animation. Dry-run by default.

Add a CapCut video effect on an effect track over a time range: kind scene (video_effect) or body (face_effect, follows people), by resource_id (e.g. scene 7434872753355756048 = Grafiti de tiza, body 7688574067632377106 = Figura neon; both free). Dry-run by default.

Add an adjustment layer (CapCut 'Ajustar') over a time range, with optional basic adjust (same keys and UI values as capcut_set_clip adjust) and LUT. It affects every track below it. Dry-run by default.

Move a track up or down among the tracks of its type (layer order: position 0 = bottom). The main video track stays at 0. Dry-run by default.

Batch cut list: place the keep ranges of one video/audio file (or everything except the cut ranges) back to back on a track from start_s, snapped to the draft's frame grid, and return the time map. A keep entry may be {in_s, out_s, x?, y?, scale?} so each speaker turn gets the same transform as capcut_set_clip. Optional source SRT is remapped through the cuts (cues in cuts dropped). srt_out writes that remapped SRT (frame-snapped, full cues, not the short cards) and never overwrites; dry-run by default. place_subtitles false skips burned-in captions. Re-chunking matches capcut_add_subtitles. Dry-run by default.

Delete the segment that starts at start_s on a track (any type) and the materials only it used. ripple: true pulls the later segments of that track left to close the gap (other tracks do not move). Dry-run by default.

Add timeline markers (CapCut time marks), e.g. chapter points for a YouTube description: [{t_s, title, color}]. Dry-run by default.