Repository navigation
Creator workflow
Import media in Media, drag it to a track, then select a clip. The Creator panel under the inspector exposes speed curves, motion presets, visual effects, audio processing, transitions, cutout and advanced assets. Preview and Export use the shared backend renderer.
Choose a speed preset, then edit individual time/rate points. The curve expresses source speed over timeline time; changing it does not automatically change the clip's timeline duration. Use trim to choose duration. A motion preset creates ordinary editable keyframes.
Visual/audio stacks process top to bottom. Each has an amount control; a visual entry's declared parameters render below it as sliders carrying the catalogue's minimum, maximum, step and unit, with a localized label and a reset to the declared default. The renderer clamps incoming values to the same declarations, so out-of-range values from any caller render clamped. Audio volume ranges from zero to four; pan ranges from left to right. Detach audio creates an audio clip preserving timing, then mutes the source video.
Select several clips with Shift or Cmd click, a marquee drag on empty lane space in the select tool, or Cmd+A; Esc clears. Moving, deleting, duplicating, pasting or muting a multi-selection acts on the whole set as one undo step, keeps relative offsets, and a move is refused whole if any member would land on a locked track. New projects start from a format sheet (9:16, 16:9, 1:1, 4:5 and a frame rate); work saves itself two seconds after the last change unless autosave is off in Settings > Project, and unsaved work is journaled so the start screen can restore it after a crash.
Upload a .cube LUT or .wgsl shader under Advanced. Examples are provided in examples/. WGSL uses group 0 bindings: 0 is read-only storage array<vec4> input RGBA, 1 is read-only storage array containing width, height, time and zero, and 2 is writable storage array<vec4> output. Entry point main uses workgroup_size(64). Index bounds are the shader author's responsibility. Compilation is checked on import.
Expressions support t, duration, value, pi, arithmetic and sin/cos/tan/abs/min/max/sqrt/floor/ceil. They do not execute Python or JavaScript. Blank expression removes the override. Preview selection handles currently reflect keyframes rather than expression-driven geometry.
Open Studio > Local models to download or import segmentation models and Kokoro speech files; the panel also names the Processor the model sessions run on. Downloads are explicit and cancellable. The default object cutout (U2NetP) ships inside the engine, so Remove background works before anything is downloaded; A person (U2Net human segmentation), Fine edges (IS-Net), Video matting (people, an explicit download of upstream's GPL release), and Point to select (SAM 2, with SAM 2.1 tracking fetched beside it for video) are downloads, and Subject (Auto) picks person when the person model finds someone, else object, once both are present. In Creator > Cutout choose the model, set threshold and softness, then Enable cutout. Choose Restore or Erase and paint on preview, or Smart restore and Smart erase, which turn the stroke into a prompt on the frame it was painted on and keep the whole region the segmenter finds there rather than a brush mark. Strokes are saved in source coordinates, a smart stroke with its region and source time; one stroke is one undo step. Remove last stroke or remove cutout to reverse edits.
The launcher (./formcut, formcut.bat) installs the speech runtime after the main install, idempotently, into an external Python environment in the data directory; setup/setup_local_ai or setup/setup_local_ai.bat re-runs that step alone. Install the Kokoro model and voices through Studio. Studio > Local speech generates audio into the bin and timeline. Text > Speak uses the same local engine for the selected title. The historical ElevenLabs API remains for compatibility, but those controls use Kokoro.
Studio > Stock media searches Pexels for video or photos with orientation, size and (for photos) colour filters and pages the results. Each card can add the item to the media bin, place it on a new track at the playhead, download the imported file, or open its Pexels page; the photographer credit and page URL are stored with the import.
Templates are full timeline documents. Studio > Templates can save the current document, export/import .fctemplate files, and bind each named media slot to available media. Duration fitting adjusts source rate. LUTs, shaders and imported fonts are embedded and remapped on import. Source footage is represented by slots, not embedded. Filled templates create an unsaved independent project.
Text can use an uploaded TTF/OTF font from the inspector. Use a font containing the script you intend to render; platform fallback cannot guarantee all glyphs. The interface is fully translated into sixteen languages, every key and every phrase in each, with Arabic, Persian and Hebrew right to left; the Translation page says where the strings live.
Effects, Filters and Transitions are driven by the engine catalogue rather than a hardcoded list: 27 visual effects grouped as Blur, Stylize, Distort and Texture, 39 colour grades grouped as Adjust, Film, Warm, Cool and Split, 20 audio chains as Voice, Tone, Space and Clean, two shape masks, the cutout models and all 12 transitions. Every card's thumbnail is a real render of the example image through the same effect, mask or transition code the renderer uses, cached on disk, so a card shows what the effect does. Clicking a card toggles that entry on the selected clip's own stack; refusals say why (no selection, an audio chain on a still, a cutout whose model is not installed).
The playhead has a grab handle, and both it and the ruler scrub under pointer capture: playback pauses, the position snaps to clip edges while the magnet is on, and it always lands on a frame. Transcription appends captions to the track named in the caption picker, and if that track already holds clips across the caption span it creates a Captions track instead, so nothing is written over.
A marked range is a span on the timeline that Extract and Lift act on, drawn as a band across the tracks. The Pro tab's In and Out set it, and so does Mark range on a transcript row, which finds where the speech under that sentence starts and stops in the audio (the voice-activity map when that model is downloaded, the loudness of that stretch otherwise) and marks from onset to offset. Extract, in the timeline's tab row, takes the range out of every track and closes the gap; Lift leaves the gap. Either clears the range. The transcript only marks: its time buttons seek, and it has no cut, copy or paste of its own.
Project files and linked media. File > Save as project file writes the project to a .fmc file wherever you
choose (for instance ~/Documents/Client/Launch.fmc); from then on every save, the autosave included, writes that file
too. File > Open project file reads one back. Import, on the computer formcut runs on, opens the system's own dialog
and links the files where they are rather than copying them (the library keeps a link to each file, its path and a
fingerprint; deleting it from the library removes only the link). A .fmc records, for every file its clips use,
where the file is, where it is relative to the .fmc (so a project folder moved or handed over whole finds its
footage), and its fingerprint. When a file is not where the project last found it, the Missing media dialog lists it:
Locate it with the system's dialog and the others are looked for beside it, or Search a folder and every missing file
is looked for there and below, by name and then by fingerprint (a renamed file too); a file of another length is asked
about first. Cmd+S saves; for a project not yet kept in a file it offers Save as project file once, and Shift+Cmd+S always
does. File > Collect files makes a folder named after the project holding its .fmc and a copy of every file its clips
use in Footage/ (two files of one name told apart), the .fmc pointing at them relative to itself, so the folder
can be moved, zipped or handed over whole; the project itself stays kept where it was. The start screen opens a
project file too, and shows the .fmc each project is kept in. The .fc package stays the way to hand a project over
as one zipped file.
Any picture or video can be seen full screen, on its own: View on a media library card (or Space on a focused card), View on the start screen's media, or a click on a result in Studio's image generator. The viewer sits above everything; Escape, a click outside its bar, or Close returns, and the arrow keys move through the pictures and videos beside it.
Caption looks: fourteen ship with formcut, six of them animated, the spoken word
fading in as the words arrive (reveal) or rising into place (rise) over its first
0.15 s. After them comes every installed captions package, among them the ones
installed from the community registry (the effects browser's Community packages).
Share this look in the Captions panel saves the panel's look as a captions
package zip, made the way the registry's own packages are, which any formcut
installs as it is and which setup/registry_entry.py lists in the registry
(.docs/registry/README.md).
Thirty-one appearance profiles live under Settings, Appearance: Studio, the form family's profile shared with formvfx and formvis and the default since 2.9.1, twenty-eight palettes generated from one ladder table, plus two behaviours that pick a palette (on every click, or every twenty seconds). Every profile wears the same family chrome: panes with a near-black rim, tabs in a darker strip, the chosen tab as a raised pill, and the accent as a tint with a line on primary actions rather than a solid fill. The accent is separate and free; a profile names a default and a chosen accent overrides it. A stored profile and accent are applied before the first paint, so nothing flashes; a store from before 2.9.1 that held formcut Dark, the old default, opens in Studio once, and choosing formcut Dark again is kept.
Panes resize by dragging the dividers between them, or from the keyboard with arrow keys, Home and End once a divider has focus. The side panels can swap and the timeline can sit above the panes; sizes and slots persist.
Under the timeline, a lane per animatable property shows a diamond per keyframe. Click empty lane to add one holding the value the clip already has, drag to move it frame-snapped, alt-click to remove, double-click to cycle its easing. The curve view shows one property as value over time with points draggable in both axes, drawn with the renderer's own sampler, so the line is the animation. Its eased-curves toggle (on by default) switches between that sampled line and dashed straight segments between the keyframes. In the inspector, the scale, position and rotation rows also carry a slider under the number field.
Track heights drag from a grip on the bottom edge of each track head (double click resets). A work area on the ruler, created by a double press or with B and N at the playhead, has a grip at each end; playback starts inside it and loops back to its start, and double-clicking the bar clears it.
The home screen is a library: projects as cards, media as a searchable and filterable grid with thumbnails, templates, local models and a storage breakdown. Files dropped anywhere on it are imported. Media can be renamed, revealed in the file manager and deleted from there; a rename changes the library entry only, so a project's references cannot break.
Split (S, Cmd+B), rejoin, freeze frame (F), reverse, crop with canvas grips, vertical flip, reattach from either clip, canvas alignment guides (Alt bypasses), the Easy tool tray, the per-kind clip panel, favourites and hover audition.
Full title styling in the inspector, double-click typing on the canvas, a ten-style gallery, presets that carry their font, and captions with model, placement, size, words per caption, cancel and typed lines.
Replaying an unchanged range is served from cache, an edit re-renders only its own span, and volume and fade changes are heard immediately during playback.
A thirteen-control colour panel, imported LUTs as library looks with intensity, keyframes on effect parameters and volume, linear and inverted masks, In/Out/Combo animations that survive trimming, audio strength sliders, and tape-style pitch.
Remove background in Easy with four modes, and an export sheet offering codec, size, 10-bit and a live size estimate.
Import an effect package, open a template that brings its own music and fonts, follow the OS light or dark setting, and drop in a corrected translation without waiting for a release.
- Bring media in. Drop files, import from the library, pull from Pexels, paste a link into the media downloader (any site yt-dlp supports), or generate an image, a video or a sound with your own provider key.
- Lay it out. Multiple timelines with tabs you can reorder by dragging, rename by double-clicking and remove; multi-select with a marquee; a magnetic main track that closes gaps; per-timeline width, height and frame rate.
- Cut. Split (S), split everything under the playhead (Cmd+B), rejoin pieces, ripple delete, freeze a frame (F), reverse a clip, reattach detached audio.
- Frame. Crop with grips on the canvas, flip, and move or scale with alignment guides that snap to edges, centres, thirds and other layers.
- Grade and treat. A thirteen-control colour panel first, then effects, then LUT looks at any intensity, then shader, then key, cutout and mask, then the transform.
- Mask. Fourteen shapes with angle, feather and invert, or draw a path with the pen tool and edit its anchors and bezier handles.
- Animate. Keyframe any transform property, effect parameter or volume, with real cubic-bezier easing and named presets, or use an In, Out or Combo animation slot that rescales when the clip is trimmed.
- Title. Weight, italic, outline, shadow, plate, line height, letter spacing, wrap and opacity; a gallery of ten styles; type straight onto the canvas.
- Caption. Transcribe locally with Whisper in tiny, base or small, choose placement, size and words per caption, or type the lines yourself.
- Set the range. Drag the composition range on the ruler to choose what plays and what exports.
- Export. H.264, HEVC, AV1 or VP9, 10-bit where supported, at a size and frame rate you choose, with an estimate before you commit.
Pages
- Home
- Architecture
- Creator workflow
- Automation
- Extensions
- Packaging
- Translation
- Mobile notes
- Models
- Licences
In the repository
These pages are published from .docs/wiki/ in the repository. Edit them there;
a push to main updates this wiki. Editing a page here is overwritten by the
next publish.