
fablecut
- GitHub stars
- 803
Install
/plugin install fablecut@fablecutRun it inside Claude Code after adding the marketplace with /plugin marketplace add ronak-create/FableCut.
Contents
Discovered from sourceSkills 3
Editing video with FableCut
FableCut is a browser video editor whose entire timeline is one JSON document. You edit video by patching that document; the open editor UI hot-reloads within ~150 ms, so the user watches the timeline rebuild as you work.
Start here, every time
fablecut_status— starts the editor server if it isn't running and returns the URL, the current project summary, and what's inmedia/. Call it before anything else. If the user doesn't have a browser tab open, tell them the URL so they can watch.fablecut_docs— the full manual:project.jsonschema, every prop, transitions, text animations, and a recipe book. Request a single section ({section:"props"},{section:"Recipes"}) rather than the whole document. Skip it entirely if the schema is already in context.
Making edits
Prefer fablecut_patch_project. It sends only what changes, re-reads the
latest document internally, and is merge-safe — it will not clobber a tweak the
user just made in the UI. Batch related changes into one call; ops apply in
order and bump the revision once.
fablecut_patch_project {ops:[
{op:"updateClip", id:"c_v2", set:{props:{filterPreset:"teal-orange"}}}
]}
Use fablecut_get_project {compact:true} to plan — it's roughly 10× smaller
than the full JSON. Fetch the full document only when you need exact keyframes.
fablecut_set_project replaces the whole document and is conflict-checked: if
the user edited in the UI since your last read, it refuses rather than
overwriting. On conflict, re-read, re-apply your change, and call it again.
Getting footage in
fablecut_import_media copies a local file into the project and registers it
with its details read from the file: duration, resolution, frame rate, codecs,
audio channels and size. The compact view's MEDIA lines show them for every
file (plus tags, favorites and uses:N), so read them there instead of shelling
out to ffprobe. Without ffprobe on the machine only the size is known at first;
the open editor fills in duration and resolution, so check a field is there
before relying on it. To organize the bin, use updateMedia (favorite, tags, folder)
and setCollection.
A file marked OFFLINE in the compact view or fablecut_status is missing
from media/: find it, put it back under media/ and relinkMedia it —
its clips keep their timing. replaceMedia swaps in a different file.
Proxies (fablecut_proxy) only make the preview smoother; export, frames and
scopes always use the originals. Make them only when the user asks.
fablecut_projects lists the user's projects and opens, creates or duplicates
them; every other tool works on the open one (./project.json). Switch, archive
or delete only when the user asks — opening another project changes what they
see — and re-read the project after a switch.
Before a big or risky change (restructuring the edit, a remake, a new look on
every shot), save a version with fablecut_versions {action:"save", name, note}
so the user has a named point to go back to; when they are happy with a cut,
save one too. {action:"diff", version} tells you (and them) what changed since.
Restore a version only when the user asks.
A project can hold several sequences (timelines sharing its media): the compact
view lists them under SEQUENCES, and every op works on the open one. For "a
vertical version" or "a 15 s cut-down", add one with {op:"addSequence", name, from:"open", width?, height?} and edit it with {op:"inSequence", sequence, ops:[…]} — the user's editor stays on what they are watching. Open one
(openSequence) only when they ask, or to export it.
For "a 30 s reel from this footage", fablecut_highlights {duration:30} picks
the best moments into a new sequence (it opens it); look at them with
fablecut_frame before building on them.
For a vertical (or square) version of a finished edit, fablecut_reframe {aspect:"9:16"} does the copy for you: a new sequence on that canvas whose
full-frame shots follow their subject with ordinary position keys. It opens
the copy, so the user's editor switches to it; say so. To build a copy without
switching their view, use addSequence + inSequence as above instead. It
leaves titles, picture-in-picture and clips placed by hand alone and lists
them: look at those with fablecut_frame on the new canvas and move them.
Things that trip people up
- Cut, ripple, trim and insert with the
fablecut_patch_projectedit ops (split,rippleDelete,extract,insert,rippleTrim,roll,slip,slide,crossfade) instead of recomputingstart/inby hand — they keep linked audio stems in sync and respect the user's locks. - Video and audio clips must satisfy
in + duration×speed ≤ media.duration. - Crossfades are same-track overlap plus
transitionIn: {type:"fade"}on the later clip — not a separate object. - Speech: read it before you cut it.
fablecut_transcribe {clipIds:[…the speech clips]}returns their words as timed lines (with no clipIds a music bed is transcribed too);find:"the line"locates it andcut:trueextracts it with the pause after it.fablecut_silence {cut:true}tightens the pauses. Whisper leaves out most "um"s, so don't hunt fillers by text. Lock the music lane before either cut. Caption it last:fablecut_captions {style:"highlight", clipIds:[…the speech clips]}(or subtitle, karaoke, pop), then look at a frame mid-sentence. - Vary the font per title. Reusing one typeface across a whole edit is the
single clearest tell of a machine-made cut;
fablecut_docs {section:"Text"}lists the built-in title styles. - Grade with the
setGradepatch op (props.grade: exposure, temp / tint, lift / gamma / gain / offset wheels, tone bands, contrast, saturation, tone curves and hue curves;setGradeLayerfor a secondary on one colour or one area — check its matte withfablecut_scopes {matte:{clip, layer}}) and check every grade withfablecut_scopes— median luma near 0.35–0.5, no clipped whites, cast strength under ~0.03 on neutral scenes.fablecut_docs {section:"Color"}has the keys and how to read the numbers. - Motion graphics (shape layers, draw-ons, lower thirds, nulls,
parenting, anchor points, motion paths, compositions, animation presets and
templates) have their own skill,
motion-graphics, and manual sections ("Shapes, nulls and parenting", "Compositions (nested sequences)" and "Presets and templates" under{section:"schema"}). For a quick lower third or a title that slides in,addTemplateandapplyPresetare one op each. - Export with
fablecut_export— the editor's own Fast export, in the user's open tab or a headless Chrome / Edge. It needs ffmpeg on PATH; it waits for the file and returns its path. For a platform, pass its preset (preset:"youtube","youtube-shorts","instagram-reels","tiktok","x","linkedin","broadcast","web","archive") and adjust withdelivery:{…}(fps, codec, bitrate, file name, metadata); a 16:9 timeline exported to a vertical preset is cropped from the middle unless the project has an export frame, so say so, set one, or make a reframed copy first (fablecut_reframe).fablecut_encode_profileslists the presets. Several files at once (a master, a YouTube cut, a reel, a square…):outputs:[{preset:"master"}, {preset:"youtube"}, …]renders the timeline once per frame rate and encodes every file from it;setProject {outputs:[…]}saves the list with the project andoutputs:trueexports it.delivery:{audio:{loudness:-14}}normalizes the mix (−23 for broadcast); the reply checks each file — read it and tell the user about any ⚠ line.
Motion graphics with FableCut
Motion graphics in FableCut are ordinary clips on the timeline, so everything you know about clips (tracks, keyframes, transitions, masks, blend) still applies. Three pieces do the work:
- Shape layer: a clip with
kind:"shape"that draws vector items fromprops.shapes. It stays sharp at any scale and needs no media. - Null: a clip with
kind:"null"that never renders. It exists to be a parent. - Parent:
"parent":"<clip id>"makes a clip move, turn and scale with another one. Every visual clip also has an anchor point (anchorX,anchorY) that it turns and scales around.
For the full key table, read fablecut_docs {section:"schema"} once and see
its "Shapes, nulls and parenting", "Motion paths, motion blur and text on a
path", "Compositions (nested sequences)" and "Presets and templates" parts. The notes below cover how to use it well.
Coordinates (get these right first)
- A clip's
x/yare px from the canvas centre. When it has a parent, they are px from the parent's centre, in the parent's turned and scaled space. - A shape item's
x/yare px from the layer's origin (the layer clip'sx/y). Path and linepointsare px around the item's ownx/y. rotationis in degrees, clockwise, and y points down.- Item
keys[].tand clipkeyframes[].tare seconds from the clip's start, not from the timeline.
Workflow
fablecut_get_project {compact:true}to see the tracks and what is free. Shapes usually go on V2/V3 above the footage.- Add the layer with its items in one
addClip, or add an empty layer and thensetShapeitems into it by name. Name every item you plan to touch again (name:"Bar"), so later edits sayshape:"Bar"and not an index. - Animate the items with
keys, and the whole layer with clipkeyframes(x,y,scale,rotation,opacity,trimEnd, and so on). - Group things that move as one: put shapes in a
groupitem inside a layer, or parent whole clips (titles, images, other layers) to a null withsetParent. - Check it:
fablecut_get_project {compact:true}shows each layer as[3 shapes: rect #ffd166 2 keys, …]and each child asparent:c_….
fablecut_patch_project {ops:[
{op:"addClip", clip:{id:"c_lt", kind:"shape", track:"V2", start:1, duration:5,
props:{x:-330, y:230, shapes:[
{type:"rect", name:"Bar", x:0, w:560, h:96, radius:10, fill:"#111827e6",
keys:[{t:0, w:0}, {t:0.5, w:560, ease:"ease-out"}]},
{type:"rect", name:"Accent", x:-276, w:8, h:96, fill:"#ffd166"},
{type:"line", name:"Rule", y:64, points:[[-280,0],[280,0]], stroke:"#ffd166", strokeWidth:4,
keys:[{t:0.3, trimEnd:0}, {t:1, trimEnd:100, ease:"ease-out"}]}]},
transitionOut:{type:"fade", duration:0.4}}},
{op:"addClip", clip:{id:"c_name", kind:"text", track:"V3", start:1.2, duration:4.8,
props:{text:"Ava Moreno", font:"Archivo Black", fontSize:44, align:"left", x:-560, y:-8, textAnim:"rise-mask"}}},
{op:"setParent", id:"c_name", parent:"c_lt"}
]}
setParent keeps the title where it is on screen and rewrites its x/y
into the layer's space. After that, keyframing the layer's x slides both of
them out together.
Timing that looks designed
- Entrances take 0.3–0.6 s with
ease:"ease-out"on the arriving key. Exits are faster (0.2–0.4 s) withease-in. Uselinearonly for things that keep turning or running (spinners, tickers, atrimOffsetloop). - Stagger related items by 0.08–0.15 s so they settle one after another instead of all at once.
- Overshoot comes from three keys, not from an ease:
scale0 → 1.12 → 1 over about 0.35 s. - Hold a finished graphic for at least 2 s before it leaves.
- Use two or three colours: one strong accent, one neutral (
#111827,#ffffff), and a translucent backing (#rrggbbaa, such as#000000a0).
Recipes
- Draw-on logo or icon:
pathitems withstrokeandfill:"none", each withkeys:[{t:a, trimEnd:0}, {t:a+0.8, trimEnd:100}], staggered. Then fade in the fill:keys:[{t:1.2, fill:"#ffffff00"}, {t:1.6, fill:"#ffffff"}]. Thefillmust be keyed in the same item as the draw-on. - Whole-layer draw-on: key the clip's own
trimEnd0 → 100 in itskeyframes. It trims every path in the layer at once. - Loading ring:
{type:"ellipse", w:120, h:120, fill:"none", stroke:"#ffffff", strokeWidth:10, trimEnd:25, keys:[{t:0, trimOffset:0}, {t:1, trimOffset:100, ease:"linear"}]}. For more turns, add more keys (trimOffset200 at t 2, and so on). - Progress bar: a backing
rectand a fillrectwithkeys:[{t:0, w:0, x:-200}, {t:3, w:400, x:0, ease:"linear"}]. Keyxtogether withwso the bar grows from its left edge. - Orbit: a null at the centre with
rotationkeyed 0 → 360 (linear), and a shape or image parented to it withx:300. A second null parented to the first gives a moon. - Swing or hinge: put the anchor on the edge it should hang from
(
anchorY: -h/2for the top edge), then keyrotation−8 ↔ 8. - Pop-in sticker: a
starorellipseitem with keys[{t:0, scale:0}, {t:0.25, scale:1.15}, {t:0.4, scale:1}]androtation−15 → 0. - Callout: an open
path(closed:false) from the subject to a label, drawn on withtrimEnd, plus a smallellipsedot at its start. - Burst: a
groupof sixlineitems withrotation0, 60, 120… andpoints:[[40,0],[90,0]]. Key the group'sscale0.4 → 1.2 and itsopacity1 → 0 over 0.5 s.
Curves, blur and text on a path
- Curved moves: key
xandytogether at two or more times (position keys), then call{op:"setMotionPath", id, path:"smooth"}. For a precise arc, write the handles yourself:pouton the leaving key andpinon the arriving key, on both the x and y keys, in px from the key's position. A fly-in that arches up: x{t:0, v:-500, pout:200}→{t:1, v:0, pin:-200}, y{t:0, v:200, pout:-250}→{t:1, v:0, pin:0}. - Auto-orient (
autoOrient:trueorsetMotionPath … autoOrient:true) makes arrows, planes and cars point where they go. Draw them pointing right (0°), the direction of travel. - Motion blur:
motionBlur:180on anything that moves fast (whips, fly-ins, spinning logos). Use 360 for a heavy smear. Leave it off on slow drifts, where it only costs render time. 8 samples is enough for most shots; use 12–16 for very fast spins. - Text on a path:
{op:"setTextPath", id, path:"circle"}(or"arc","wave","line", or a shape item such as{type:"path", points:[…], closed:false}). KeypathOffset0 → 100 withease:"linear"to send text around a ring. Add a trailing " • " so the ends don't touch. Size the path to the text: the circle's circumference (π × w) should be a bit longer than the text.pathAlign:"center"withpathOffset:50centres a title on an arc. - Multi-line text on a path: each line after the first runs on a parallel
curve one line-height below. Every
textAnimworks on a path;letter-popandrise-maskread especially well on arcs.
Compositions: build once, use anywhere
A comp (project.comps) is a timeline of its own; a kind:"comp" clip
places it, drawn like one picture of the comp's size. Use one when the same
graphic appears more than once, or when several clips should move, fade, mask
or grade as a unit.
fablecut_patch_project {ops:[
{op:"addComp", comp:{id:"sting", name:"Logo sting", duration:2.5, clips:[
{id:"ring", kind:"shape", track:"V1", start:0, duration:2.5, props:{shapes:[
{type:"ellipse", w:220, h:220, fill:"none", stroke:"#ffd166", strokeWidth:10,
keys:[{t:0, trimEnd:0}, {t:0.8, trimEnd:100, ease:"ease-out"}]}]}},
{id:"word", kind:"text", track:"V2", start:0.5, duration:2, props:{text:"FC", font:"Anton", fontSize:96, textAnim:"zoom-in"}}]}},
{op:"addClip", clip:{kind:"comp", compId:"sting", track:"V3", start:0, duration:2.5}},
{op:"addClip", clip:{kind:"comp", compId:"sting", track:"V3", start:58, duration:2.5, props:{scale:0.6, x:480, y:260}}}
]}
- Edit what is inside with
{op:"inComp", comp:"sting", ops:[…]}(the same clip ops, with comp times). Every placement updates. {op:"precompose", ids:[…]}turns clips you already built into a comp and leaves one comp clip in their place; then animate, mask or fade that clip as a whole (this is the fix for "parenting doesn't pass opacity").- A comp clip's
inis where in the comp it starts. A comp clip shows nothing past the comp'sduration, so lengthen the comp (updateComp) before stretching the clip. - The comp's frame is its
width×height, transparent unless it has abackground. Make a graphic's comp the canvas size sox/yinside it read the same as on the timeline. - Sound inside a comp plays through the main timeline's track of the same name, so a whoosh in a sting follows the A-track fader it is on.
Presets and templates: start from something designed
Reach for these before keying by hand.
fablecut_patch_project {ops:[
{op:"addTemplate", template:"lower-third-bar", id:"c_lt_ava", track:"V3", start:4,
fields:{name:"Ava Moreno", title:"Director of Photography", accent:"#22d3ee"}},
{op:"addTemplate", template:"logo-ring", track:"V3", start:0, fields:{logo:"m_logo", brand:"NORTHWIND"}},
{op:"applyPreset", ids:["c_title1", "c_title2"], preset:"rise-blur"},
{op:"applyPreset", ids:["c_title1", "c_title2"], preset:"fade-out"},
{op:"applyPreset", id:"c_badge", preset:"pulse", at:12.5}
]}
- Templates (
addTemplate): lower thirdslower-third-bar,lower-third-underline,lower-third-boxes(fieldsname,title,accent…); logoslogo-ring,logo-slam,logo-lines(logotakes a media id: import the user's logo first); socialsocial-story(1080×1920),social-quote(1080×1080),social-end-card. Each placement is its own comp, so one per speaker is right. Change it later with{op:"setTemplate", id:"c_lt_ava", fields:{…}, duration:7}; a longer template holds longer and keeps its exit. For a vertical template, set the canvas to its size first (setProject {width:1080, height:1920}) or it sits letterboxed in a 16:9 frame. - Presets (
applyPreset) key relative to the clip, so put the clip where it should rest first, then apply. One In and one Out per clip; an At preset (pulse,shake,wobble,bounce,flash) on a beat; a loop (float,breathe,sway,spin,wiggle) for something that lives on screen.lengthstretches one (length:1.2for a slow, grand entrance). - Use one family of entrances across an edit (say
rise-blurfor titles andpop-infor stickers) rather than a different preset on every clip. - Save what the user likes:
savePreset {id, name}from a clip they animated,saveTemplate {comp, name}from a comp they built. Both go to the library and work in every project.
Things that trip agents up
- Shape and null clips have
mediaId:null. Don't register media for them. - A new item needs
type.setShapewithoutshape(or with a new name) adds an item; with an index, name or path ("2.0"= item 0 in group 2) it edits that item and merges key by key. keysinsetShapereplaces that item's whole key list, so send all of them.pointskeys must have the same number of points as the path.- Lines have exactly 2 points. Paths need 2 to 128, and a closed path needs 3 or more to show any area.
- A stroke with
strokeWidth:0is invisible. Settingstrokewithout a width gives 6 px (8 px on lines and open paths). - A trimmed closed shape fills only the part that is drawn. For a clean
outline draw-on, use
fill:"none"and fade the fill in afterwards. - Parenting carries only the transform. Opacity, transitions, shake and
effects don't pass to the children, so fade each child with its own
transitionOut, or put everything in one shape layer's groups. - Rotate or scale around a corner by moving the anchor, not by adjusting
x/ykeys in every frame. - Parent loops (for example, a null to its own child) are refused, and so are parents that are audio or adjustment clips.
- A comp can't contain itself (directly or through another comp), and
removeCompis refused while a clip still uses it. Comps nest 4 deep.
Remaking a reference edit
Given a video the user likes, FableCut extracts what is measurable about the edit — where the cuts land, where the beats are, how energy moves — and hands it back as a blueprint. The structure is deterministic; the creative mapping onto new footage is yours.
Get the blueprint
fablecut_analyze_reference {path:"C:\\…\\ref.mp4"}
Needs ffmpeg on PATH. It returns shot boundaries (cuts, shots[] with a
per-shot energy 0–100), music beats[] and bpm, a loudness energy curve,
and drop — the biggest musical rise. It also extracts the reference's music
track into the project and registers it as media, so the rebuild can sit on the
same song.
If obvious cuts were missed, lower threshold; if camera motion is being read
as cuts, raise it.
Rebuild
- Match the canvas: copy the reference's
width/height/fpsonto the project. Writebeatsintomarkersso the user can see the grid and the UI snaps drags to it. - Music on A1,
in: 0, running the full reference duration. - One clip per
shots[]entry on V1 at the samestartandduration. Match footage to each shot'senergy— calm material under ~40, motion over ~70 — and choose each clip'sinso something actually happens inside the window. - Land the hero shot on
drop. The standard garnish is a speed ramp settling into it, anadjustlayer withshake+rgbSplitfor one impact frame, or a whip transition on the way in. - Pace to taste: shots under ~0.6 s read as beat-flashes.
avgShotLentells you the reference's overall rhythm. - With the user's own music instead of the reference's,
fablecut_beats {clipId}finds its tempo, beat and drop;snap:truerolls the cuts onto the beat,retime:{every:2}re-cuts V1 so each shot lasts 2 beats. - Posting it vertically:
fablecut_reframe {aspect:"9:16"}makes a copy whose shots follow their subject.
No reference, just long footage? fablecut_highlights {duration:30} picks its
best moments (movement, sound, a clear picture) into a new sequence; then
steps 6 and 7. Look at the picks with fablecut_frame {time} and swap any
that miss.
Full recipe, including the exact keyframe shapes for speed ramps and impact
layers: fablecut_docs {section:"Remake a reference video"} and
fablecut_docs {section:"Recipes"}.
Be honest about what this does
The blueprint captures structure — timing, pacing, where the energy sits. It does not capture look, subject, or performance. Tell the user that a rebuild matches the rhythm of the reference and that the grade, footage, and titles are separate choices, rather than implying the result will look like the original.
Only analyze video the user has the right to use as a reference, and don't reproduce a reference's actual footage — the point is to reuse the structure with their own material.
MCP servers 1
Sponsors
Details
- Marketplace
- ronak-create/FableCut
- Category
- Media