filmcraft
Skill36 starsChanged 11 days agoMITView on GitHub
Video editing with FilmCraft (Premiere Pro-style): cut clips into a sequence, trim, razor, ripple, transitions (cross dissolve, dip to black), titles and lower thirds, animated graphics, music and audio levels/fades, color (Lumetri), speed changes, captions/subtitles (SRT/VTT, burn-in), transcript-based editing, text-to-speech narration, vertical 9:16 cuts for TikTok / Reels / Shorts, and export to MP4 / HEVC / ProRes / DNxHR / GIF / WAV / FLAC or FCP XML / EDL / OTIO / AAF.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- kjranyone/artcraft-agent-skillstheir own version, first seen Nov 15, 2026
- rawphp/skillstheir own version, first seen Nov 1, 2026
- midasmatterhorn/artcraft-skillstheir own version, first seen Oct 17, 2026
- OmkarPalika/filmcrafttheir own version, first seen Jul 20, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- midasmatterhorn/artcraft-skills★ 82same name
- OmkarPalika/filmcraft★ 2same name
- kjranyone/artcraft-agent-skills★ 1same name
- rawphp/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository18 other files it gives its agents.
- cadcraftSkill
- craft-anythingSkill
- deckcraftSkill
- designcraftSkill
- effectcraftSkill
- figcraftSkill
- gridcraftSkill
- lightcraftSkill
- materialcraftSkill
- pdfcraftSkill
- photocraftSkill
- solidcraftSkill
- soundcraftSkill
- storytold-installSkill
- storytoldSkill
- texturecraftSkill
- vectorcraftSkill
- wordcraftSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 1 is distinctive, and 4 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 23
Use it for editing footage on a timeline:
- Very specific: line 44
If tools named mcp_filmcraft_* are available, use them.
- Very specific: line 212
Place the picture with timeline.place {item, track:"V1", audio:false} so its own sound doesn't fight the voice.
- Very specific: line 288
Place music and titles last, or timeline.setTrack {track:"A2", syncLock:false}.
- Very specific: line 317
After export: ffprobe -v error -show_entries format=duration:stream=codec_name,width,height out.mp4, extract frames (ffmpeg -ss 2 -i …
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
FilmCraft
FilmCraft is a free, open-source clean-room take on Adobe Premiere Pro (storytold Crafting Apps), with its own
H.264/ProRes/AAC codecs (no FFmpeg). An agent drives it through an MCP server (filmcraft-cli mcp) or one-shot CLI
commands. Projects are .fcproj files; every edit is an undoable engine command.
This skill is tested against FilmCraft 0.17.0.
When to Use
Use it for editing footage on a timeline:
- assembling clips into a video: cuts, trims, ripple deletes, reordering, J/L-style audio, speed changes
- transitions (cross dissolve, dips, wipes), titles and lower thirds, simple shapes over picture
- music beds with gain and fades, audio crossfades, loudness-normalized exports
- colour correction with Lumetri, effects such as blur, crop, drop shadow
- captions/subtitles: build from a transcript, import/export SRT/VTT/SCC, burn into the export
- a quick scratch voice-over: text-to-speech narration clips (built-in robotic voices)
- vertical 9:16 cuts with the TikTok / Instagram Reels / YouTube Shorts export presets
- exporting deliverables (MP4, HEVC, ProRes, DNxHR, GIF, PNG/EXR sequence, WAV, FLAC, AAC) and timelines for other NLEs
Pick a different Crafting App when:
| The job is… | Use |
| Animated graphics, kinetic type, logo reveals, keying/tracking VFX, anything keyframe-heavy | effectcraft (render an overlay, import it here) |
| Detailed audio work: mixing a podcast, noise cleanup, mastering | soundcraft |
| A still: thumbnail, poster frame retouch | photocraft / vectorcraft |
Setup
- If tools named
mcp_filmcraft_*are available, use them. This is the preferred way. - Otherwise check for the CLI with
filmcraft-cli --version. If it's missing, load thestorytold-installskill and run itssetup filmcraft. Then ask the user to start a new session or run/reload-mcp. - Until the MCP tools appear, use the CLI (see CLI).
filmcraft-cli mcp is headless and starts with an empty project (mcp --project p.fcproj or mcp --demo to
start with content). For the user to watch live, they run filmcraft --control 9876 and the server is started as
filmcraft-cli mcp --bridge 127.0.0.1:9876; then the ui_* tools work (bridge mode not tested here). There are no
--autosave or --automation-*-root flags (unknown mcp option): save with file.save yourself.
Mental Model
- Project → bins/items → sequences → tracks → clips. Items are media (Movie, Audio, Still), sequences and graphics.
A sequence has video tracks
V1..(V1 at the bottom, higher tracks draw on top) and audio tracksA1... - Ids everywhere.
media_importreturns item ids,timeline.placereturns clip ids ([video, audio]for a movie with sound; they are linked). Ids are plain integers; read them from replies ordoc_inspect. - Time is ticks: 254016000000 per second. Most commands also accept
seconds,frameortimecode. Ticks must be integers. Clipstart/endare sequence time;sourceIn/sourceOutare media time. - Every edit is a command (716). Discover with
command_list {filter}, run withcommand_run {id, params}, or several withcommand_batch. Unknown ids/tracks are errors, never a different target. - Linked selection is on: an edit to a video clip also hits its linked audio (razor cuts both, gain sets both).
To act on one side only, select it with
timeline.select {clips: [v], linked: false}, then run the edit with noclips(e.g.edit.clear {}removes the picture and keeps the sound). - Sync lock is on for every track: ripple edits refuse to run if they would push a clip on another track out of sync (see Pitfalls).
Tools (Hermes names them mcp_filmcraft_<tool>)
| Tool | Use it for |
doc_inspect / project_inspect / sequence_inspect | Project tree with item ids; the active sequence: tracks, clips (start/end, sourceIn/Out, speed, gainDb, effects), transitions, markers. sequence_inspect is long |
media_import {paths: [..], bin?, image_sequence?} | Import files by absolute path → {items, errors} |
command_run {id, params} | Run any command |
command_batch {steps:[{id, params}], stop_on_error?} | Several commands in order → {completed, failed, results} (each its own undo step) |
command_list {filter?, enabled_only?} | Find command ids and their params docs |
render_frame {seconds?, max_side?} / render_preview | PNG of the Program frame (max_side default 960, 0 = full size); leaves playhead and selection alone. Look at it |
(bridge only) ui_inspect, ui_elements, ui_click, ui_drag, ui_key, ui_type, ui_screenshot, ui_control | The live window |
Resources: filmcraft://document (as doc_inspect) and filmcraft://commands (as command_list). The tools reject
unknown arguments (unknown argument "text" for media_import; expected: bin, image_sequence, paths).
Editing building blocks
- Sequence:
file.newSequence {name, width, height, fps}→{sequence}. Defaults are 1920×1080, 23.976 fps, 3 video + 3 audio tracks.sequence.open {item}makes a sequence active afterfile.open. - Place:
timeline.place {item, track: "V1"|"A2"|"new", seconds | time | frame, insert?: bool, sourceIn?, duration?, video?: bool, audio?: bool, matchSequence?}. Overwrite by default;insert: trueripples later clips.sourceInanddurationtake ticks or{seconds}/{frame}/{timecode}(duration: {seconds: 4});matchSequence: truemakes an empty sequence take the clip's size and rate. An audio track astrackplaces sound only;audio: falseplaces picture only.items: [8, 9]lays several back to back in one undo step →{clips, placed: [[v, a], …]}. - Cut and trim:
timeline.razor {seconds, track?}(all unlocked tracks),timeline.trim {clip, edge: in|out, mode: regular|ripple, delta: ticks | deltaFrames},edit.rippleDelete {clips},edit.clear {clips},sequence.closeGap {track, time},timeline.move {moves:[{clip, track, time}]},timeline.delete {clips, ripple?}(no selection needed).timeline.trim/timeline.rateStretchtakelinked: falseto trim one side of a linked pair.edit.rippleDeleteHead {clips}cuts a clip from its in point to the playhead (playhead.set {seconds}) and closes the gap; a playhead at or before the in point is refused (the playhead is at or before the clip's in point). - Speed:
clip.speedDuration {clips, speed: 200, ripple: true, reverse?}. - Transitions:
sequence.applyVideoTransition {clip, edge: "out", effect: "Cross Dissolve", frames: 20}on the outgoing clip (it ends at the cut).sequence.applyAudioTransition {clip, frames}goes on the clip's in edge, so pass the incoming clip for a crossfade at the cut (constant_powerby default).sequence.setTransition {transition, frames?, align?, params?}edits one,sequence.removeTransition {transitions: [id]}deletes it. - Titles / graphics:
graphics.newText {text, position: [x, y], size, seconds, track, time}→{clip, layer}.positionis the alignment point on the first baseline and text is left-aligned by default. Style it withgraphics.set {clip, layer?, props: {align: "center", font: "Inter", font_style: "Bold", fill_color: "#ffcc00", shadow: true, background: true, stroke: true, size, tracking, opacity}}. To animate a title, passkeyframe: trueandtime(ticks, sequence time): every prop inpropsgets a key there →{keyframes: {opacity: 2, scale: 2}}.graphics.setCharStyle {clip, start, end, style: {bold, color, strikethrough…}}styles a character range. Add shapes to the same graphic withgraphics.newRectangle {clip, position, size}(lower-third bars), or give a shape its own clip with{position, size, seconds, track, time}and noclip.graphics.list {clip}shows layers and bounds. - Audio:
clip.audioGain {clips, mode: "set"|"adjust", db},timeline.setTrack {track, volumeDb?, muted?, syncLock?},essentialSound.generateDucking, exportloudnessLufs: -14. - Effects & keyframes:
effects.apply {clips, effect}(id or name) →{applied: [{clip, effect, index}]}(it goes at the end of the stack, so existing indices stay valid), theneffects.setParam {clip, effect: id|index, param, value}; a choice param takes its index or its option name (blend: "Multiply"). To animate, passkeyframe: truewithsecondsortime(sequence time) on each key, or calleffects.toggleAnimation {clip, effect, param}once first. The reply counts the param's keyframes ({keyframes: 2}).effects.resetParamresets one. Values outside a param's range are refused (`opacity` must be between 0 and 100, got 250). Built-ins on every clip:motion(position, scale, rotation, anchor),opacity(opacity, blend),volume(level, dB). Grepreferences/effects.mdfor ids and params. - Color:
effects.apply {clips, effect: "Lumetri Color"}, theneffects.setParam {clip, effect: "lumetri", param: "saturation"|"exposure"|"contrast"|"temperature"…, value}. - Markers:
markers.add {time, name, color, comment}(colora label or#hex);markers.delete {markers: [id]};markers.exportCsv {path}writes them all. Work area:sequence.setWorkArea, exportrange: "workArea". - Narration (text-to-speech):
tts.create {text, voice?, pitch?, pace?, track: "A1", seconds | time, dir}writes a WAV, imports it and places it →{clip, item, path, duration}.[pause 1s]in the text inserts a pause.
Procedure
- Plan the cut: order of shots, target length, where titles/music go, deliverable format and size.
- Set up:
file.newSequencewith the delivery size and fps;media_import {paths}everything; note the item ids. - Assemble on V1/A1 with
timeline.place(orcommand_batch), then trim/razor/ripple. - Transitions and titles, then music last (on A2) so ripple edits aren't blocked by sync lock.
- Mix: set gains, add fades (volume keyframes or audio transitions).
- Look:
render_frameat each cut, title and transition; summarizesequence_inspect(clip start/end per track). - Save
file.save {path: "/abs/x.fcproj"}, exportfile.exportMedia {path, format, wait: true}, verify the file.
Recipe: two-clip edit with dissolve, title, music and fade (tested)
Fresh session, a 8 s / b 5 s / music 12 s: sequence 7; items 8/9/10; clips a=12/13, b=15/16; transitions 20/21;
title 23; music 25 (every object shares one id counter, so read yours from the replies).
command_run file.newSequence {name:"Edit", width:1280, height:720, fps:30}
media_import {paths:["/abs/a.mp4", "/abs/b.mp4", "/abs/music.wav"]} → {items:[8,9,10]}
command_run timeline.place {item:8, track:"V1", seconds:0} → {clips:[12,13]}
command_run timeline.place {item:9, track:"V1", seconds:5} → {clips:[15,16]}
command_run timeline.trim {clip:12, edge:"out", mode:"ripple", delta:-254016000000} # a: 0–4 s, b slides to 4 s
command_run timeline.trim {clip:15, edge:"in", mode:"ripple", deltaFrames:15} # drop b's first 0.5 s
command_run sequence.applyVideoTransition {clip:12, edge:"out", effect:"Cross Dissolve", frames:20}
command_run sequence.applyAudioTransition {clip:16, frames:20} # crossfade at the cut
command_run graphics.newText {text:"MY TRIP", position:[640,380], size:120, seconds:3, track:1, time:0} → {clip:23}
command_run graphics.set {clip:23, props:{align:"center", font:"Inter", font_style:"Bold", fill_color:"#ffcc00", shadow:true}}
command_run timeline.place {item:10, track:"A2", seconds:0} → {clips:[25]}
command_run timeline.trim {clip:25, edge:"out", mode:"regular", delta:-889056000000} # music ends with the picture (8.5 s)
command_run clip.audioGain {clips:[25], mode:"set", db:-12}
command_run effects.toggleAnimation {clip:25, effect:"volume", param:"level"}
command_run effects.setParam {clip:25, effect:"volume", param:"level", value:0, seconds:7} → {keyframes:2}
command_run effects.setParam {clip:25, effect:"volume", param:"level", value:-60, seconds:8.5} → {keyframes:3}
command_run markers.add {time:1016064000000, name:"Scene 2", color:"green"}
render_frame {seconds:1} · render_frame {seconds:3.83} → look at title and dissolve
command_run file.save {path:"/abs/edit.fcproj"}
command_run file.exportMedia {path:"/abs/edit.mp4", format:"h264", wait:true} → H.264 + AAC, 255 frames, 8.5 sThe ids above are what a fresh 0.17.0 session gives (re-run unchanged). Clips keep their own size: a 640×360 clip
sits small in a 1280×720 sequence until you set motion scale (or place it with matchSequence: true first).
Recipe: transcript cleanup and burned-in captions (tested)
The 0.17.0 release still has no speech-to-text (transcript.generate: "command transcript.generate is not
available right now: speech-to-text is not available in this build (built without the whisper feature); import a
transcript with transcript.set instead"). Bring word timings from elsewhere:
command_run transcript.set {item:8, transcript:{language:"en", speakers:[{name:"Host"}],
words:[{text:"Hello", start:50803200000, end:152409600000, speaker:0}, …]}} # ticks, media time
command_run transcript.inspect {} → words with sequence times, paragraphs
command_run transcript.search {query:"welcome to"} → {matches:[{from, to, start, end}]}
command_run transcript.removeFillers {} → {removed:1, seconds:0.2, ticks} ripple-deletes um/uh/… on all tracks
command_run transcript.removePauses {minSeconds:0.8, keepSeconds:0.2} → {removed:1, seconds:0.8, ticks}
command_run transcript.createCaptions {maxChars:32, lines:1} → {captions:3, track:24}
command_run captions.setStyle {track:"C1", fontStyle:"Bold", size:80, color:"#ffcc00"}
command_run captions.export {path:"/abs/talk.srt"} → {captions:3, format:"SubRip (SRT)"}
command_run file.exportMedia {path:"/abs/talk.mp4", format:"h264", burnCaptions:true, wait:true}captions.import {path: "x.srt"} brings existing subtitles in; transcript.extract {from, to} cuts words out by index.
captions.setStyle {track: "C1", font, fontStyle, size, color, background, anchor, margin} styles the burned-in look
(default style SemiBold, white on a dark box). size scales with the frame: 80 on a 360-line frame is about 25 px tall
text, so a 1080p export needs less. captions.duplicate {captions, delta} copies captions along the timeline.
Recipe: scratch narration (tested)
Built-in voices only: basic-female (default) and basic-male, robotic. The natural voices that tts.voices lists
(kokoro-heart, kokoro-bella, kokoro-michael…) fail with "natural voices are not available in this build (built
without the kokoro feature)".
command_run tts.voices {} → voices, pitches, pace 0.5–2, "[pause 1s]" marker
command_run tts.create {text:"Hello and welcome. [pause 1s] Let's begin.", voice:"basic-male", track:"A1",
seconds:0, dir:"/abs/narration"} → {clip:9, item:8, path:".../Narration 1.wav", duration}
command_run tts.edit {clip:9, text:"A longer new line.", pitch:"low", pace:1.2} → {clip:9, item:10, duration, fileDuration}
command_run timeline.trim {clip:9, edge:"out", mode:"ripple", delta:<fileDuration - duration>} # see Pitfalls
command_run tts.inspect {clip:9} → text, voice, pitch, pace
command_run tts.preview {text:"Try this", path:"/abs/try.wav"} # renders a WAV without touching the timelinePlace the picture with timeline.place {item, track:"V1", audio:false} so its own sound doesn't fight the voice.
Recipe: vertical 9:16 clip with an animated title (tested)
command_run file.newSequence {name:"Vertical", width:1080, height:1920, fps:30}
media_import {paths:["/abs/a.mp4"]} → {items:[8]}
command_run timeline.place {item:8, track:"V1", seconds:0, duration:{seconds:4}} → {clips:[10,11]}
command_run effects.setParam {clip:10, effect:"motion", param:"scale", value:540} # 640×360 source fills 1920 tall
command_run graphics.newText {text:"NEW VIDEO", position:[540,700], size:140, seconds:4, track:1, time:0} → {clip:13}
command_run graphics.set {clip:13, props:{align:"center", font_style:"Bold", fill_color:"#ffffff", stroke:true, stroke_width:8}}
command_run graphics.set {clip:13, time:0, keyframe:true, props:{opacity:0, scale:60}} → {keyframes:{opacity:1, scale:1}}
command_run graphics.set {clip:13, time:152409600000, keyframe:true, props:{opacity:100, scale:100}} # 0.6 s
render_frame {seconds:0.3, max_side:640} · render_frame {seconds:1.5, max_side:640} → fading/growing in, then full
command_run file.exportMedia {path:"/abs/vertical.mp4", preset:"TikTok 1080×1920", range:"custom",
startSeconds:0, endSeconds:3, wait:true} → H.264 1080×1920, 30 fps, 90 framesInstagram Reels 1080×1920 and YouTube Shorts 1080×1920 are the other vertical presets (export --list-presets).
Export and formats
file.exportMedia {path, format, wait: true, preset?, width?, height?, fps?, quality?, bitrateKbps?, bitrateMode?: cbr|vbr1Pass|vbr2Pass|crf, crf?: 0..51, audio?, audioCodec?: aac|pcm|flac, range?: entire|inOut|workArea|custom, startSeconds?, endSeconds?, burnCaptions?, captionSidecar?: srt|vtt, loudnessLufs?, proresProfile?, alpha?}. Passformat(h264,hevc,prores,dnxhr,mxf-op1a,gif,png,exr,wav,flac,aac, …): through MCP the extension is not used, andx.wavwithoutformatbecomes an H.264x.wav.mp4. Apresetsets the format too. Withoutwaitit returns{job}at once; polljobs.list, stop withjobs.cancel. Image sequences writename000.png,name001.png, …. MP4s are written fast-start (moovfirst) for upload.- Tested on 0.17.0:
h264(+crf),hevc(macOS, VideoToolbox),prores(.mov, HQ + PCM),dnxhr(a QuickTime.mov:x.mxfbecomesx.mxf.mov; usemxf-op1afor MXF),gif,pngsequence,wav,flac,aac(.m4a),loudnessLufs: -14(measured -14.0 LUFS), presets "YouTube 1080p Full HD" and "TikTok 1080×1920".file.exportFrame {path, format: "jpeg", time}writes one still. - 32-bit audio:
settings: {audio: {bits: 32, float: true}}writes 32-bit float PCM (tested: WAV →pcm_f32le);bitstakes 16, 24 or 32. WAV, AIFF and QuickTime PCM take float; FLAC and MXF refuse it ("unsupported: FLAC audio has no 32 bit float samples: choose 16, 24 or 32 bit"). - Presets (42):
filmcraft-cli export --list-presets youtube(e.g. "YouTube 1080p Full HD", "YouTube Shorts 1080×1920"). The query matches the name or the format id (--list-presets proreslists the ProRes presets). - Encode: H.264, ProRes, DNxHR, APV, MJPEG, MXF, PNG/TIFF/BMP/JPEG/TGA/DPX/EXR sequences, GIF, WAV/AIFF/FLAC/AAC. HEVC export needs a hardware encoder (VideoToolbox on macOS, NVENC, VA-API). Decode adds HEVC, VP9, AV1, MP3/Ogg, MPEG-2, animated GIF/APNG/WebP; PSD files import as their flattened image (WebP and PSD per the release notes, not tested).
- Interchange (tested):
file.exportInterchange {format: xml|fcpxml|otio|edl|aaf|omf, path}→{bytes, report}; thereportlists what the format can't carry (graphics become clips without media or gaps, FCPXML keeps transitions on V1 only, an EDL holds one video track). Import an FCP XML/OTIO/EDL withfile.import {paths}(adds its sequences), AAF withfile.importAaf.file.openonly opens.fcproj.
CLI (no MCP needed)
filmcraft-cli --project p.fcproj export /abs/out.mp4 [--start 0 --end 3] [--scale 0.5] [--preset "…"] [--no-audio]
[--format f] [--settings '{json}'] [--allow-offline] # format from the extension (.wav → WAV)
filmcraft-cli --project p.fcproj render --seconds 1 --out /abs/f.png --scale 0.5
filmcraft-cli --project p.fcproj --save exec timeline.razor seconds=2 track=V1
filmcraft-cli --project p.fcproj --save import a.mov b.wav
filmcraft-cli --project p.fcproj inspect sequence # or: inspect project
filmcraft-cli --project p.fcproj --save run edits.jsonl # one {"id","params"} per line; --keep-going skips failures
filmcraft-cli commands razor · filmcraft-cli describe timeline.trim · filmcraft-cli probe /abs/clip.movkey=value values parse as JSON when they can; --compact prints one-line JSON. Edits are discarded unless you pass
--save / --save-as (several --save runs on one project take turns). In run, each file.exportMedia line waits
for its file unless its params say "wait": false. export and render exit 1 when a clip's media is offline
(placeholder frames) unless --allow-offline. The extension picks the format for .mp4, .mov, .wav, .aiff, .m4a, .aac, .gif, but not
.flac ("give --preset or --format (unknown extension)"): pass --format flac. --end needs --start too ("custom
range: need start (startTime / startSeconds / startFrame / startTimecode)").
A --preset sets the format: out.mov with an H.264 preset becomes out.mov.mp4.
Pitfalls
- Paths: absolute everywhere (
media_import,file.save, exports,tts.create dir). The server's cwd is not yours. - MCP exports ignore the extension.
file.exportMedia {path: "x.wav"}writes H.264 tox.wav.mp4(the reply'spathshows it). Always passformat(or apreset). The CLIexportdoes go by the extension (except.flac). - Ripple edits and sync lock: with music already on A2,
timeline.trim … mode:"ripple"fails withedit failed: this edit would break sync: A2 is sync-locked and has a clip in the way (turn off its sync lock, or lock the track, to make this edit).edit.rippleDeleteHead,timeline.delete {ripple: true}and title tracks (V2) block the same way. Place music and titles last, ortimeline.setTrack {track:"A2", syncLock:false}. - Ticks must be integers.
delta: -889056000000.0(a float) is silently ignored ({"delta": 0}). Use integer ticks,deltaFrames, orseconds. - Keyframes need the stopwatch:
effects.setParamwithsecondson a non-animated param just sets the static value (reply{keyframes: 0}; a "fade" to -60 dB mutes the whole clip). Passkeyframe: trueor calleffects.toggleAnimationfirst. graphics.newTexttrackis a 0-based index (track: 1is V2), unlike"V1"names elsewhere. A name such astrack: "V3"is silently ignored and the title lands on the first free track (V2). A shape on a busy track fails withV2 is not free here. Text is left-aligned onpositionuntilgraphics.set {props:{align:"center"}}.- Linked clips: razor and moves apply to the linked video+audio pair. Transcript edits (
removeFillers,removePauses) ripple every track, so the picture stays in sync with the speech. - Exporting an empty sequence "succeeds" with a 1-frame file. Check
framesin the export result. tts.editkeeps the clip's old length. A longer new line is cut off: the reply showsduration(the clip) andfileDuration(the new WAV). Extend it withtimeline.trim {clip, edge:"out", mode:"ripple", delta: fileDuration - duration}.tts.edit/tts.inspectneedcliponce the selection has moved (tts.edit: "commandtts.editis not available right now: select a narration clip";tts.inspect: "passitemorclip, or select a narration clip"). Withoutdir, an unsaved project writes narrations to%TEMP%\FilmCraft\Narrations; a saved one next to the.fcproj.sequence_inspectdumps every clip's effects; extractstart/end/sourceIn/sourceOutper track instead of reading it all.- Many edit commands return
nullon success; that's normal.render_framereturns the image plus "rendered frame". - Release builds (0.17.0 too) have no speech models:
transcript.generate(nowhisperfeature),transcript.downloadModel("model downloads are not available in this build (built without thespeech-downloadfeature)"),tts.downloadVoices(noneural-voicesfeature) and thekokoro-*voices (nokokorofeature).transcript.modelsreportsavailable: false. Usetranscript.setorcaptions.import, and thebasic-*voices.
Verification
render_frameat each cut, transition midpoint and title; look at the images.- Summarize
sequence_inspect: expected clips per track, no gaps, total duration as planned. - After export:
ffprobe -v error -show_entries format=duration:stream=codec_name,width,height out.mp4, extract frames (ffmpeg -ss 2 -i out.mp4 -frames:v 1 f.png) and look; check audio with-af volumedetect.
References
references/commands.md: all 716 commands with params, grouped by prefix (timeline,clip,sequence,graphics,captions,transcript,tts,export…). Grep it rather than reading it whole.references/effects.md: 131 video effects, 112 video transitions, 58 audio effects, 3 audio transitions with param ids and defaults. Grep it too.- Upstream docs: https://github.com/storytold/filmcraft/tree/main/docs (
agents.md,transcripts.md,captions.md,graphics.md,control-protocol.md).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

