Documentation
MoveMatic is a vector animation tool for product UI motion on macOS. Compose vector shapes, text, images, and video into multi-scene .mvm documents; animate every property with keyframes; add span effects, pulses, and camera zooms; and render the whole thing to MP4. This page is the complete reference.
Installation
Download the DMG from the MoveMatic page, open it, and drag MoveMatic.app into your Applications folder. The Setapp version is a one-time purchase, not part of a Setapp Membership subscription; it installs through the Setapp client, with no separate license key and no trial. macOS 14 Sonoma or later, Apple Silicon only.
Concepts
Three nested ideas drive everything else.
- Document — a
.mvmfile holds one or more scenes, a chosen active scene, and an optional document-wide audio bed. - Scene — a fixed-size canvas with its own duration, frame rate, background, layer tree, and timeline. Scenes are played back in order; each can declare a transition into the next.
- Layer — every visible thing on the canvas. Layers carry static properties (position, size, fill, stroke, corner radius, shadow, opacity, etc.) and time-based ones (visibility spans, keyframes, pulses).
The toolset is organized around those three: most edits happen in the Layer panel (organize), the Inspector (set properties), or the Timeline (animate).
Opening a document
- File → New (⌘N) creates an empty document with a single 1920×1080 scene.
- File → Open… (⌘O) opens an existing
.mvmfile. - File → Open Recent lists recently opened documents.
- ⌘S saves; ⌘⇧S saves a copy.
Each document opens in its own window. The title bar shows the filename and an Edited badge while there are unsaved changes.
Quick Look. Finder shows a thumbnail of each .mvm file — the first scene's last frame, saved with the document — and pressing Space on one previews it without opening MoveMatic. A document last saved before 3.1 shows the plain icon until it's saved again.
Sample project
The DMG ships with two sample documents under Help → Sample Documents:
- Showcase.mvm — a four-scene, ~18-second promo built around a deliberate visual story (Hello, Motion, Stories, Ship It). It exercises every shipping layer kind, span effect, pulse target, and keyframable property. Good first thing to open.
- AllFeatures.mvm — a denser feature-parade test fixture. Useful as a reference but reads as a tour, not a story.
Video tutorials
Help → Video Tutorials, or Watch tutorials on the Welcome screen, opens the tutorials window: a list of short videos on the left, the player on the right. The list streams from the MoveMatic site, so new tutorials appear without an app update; ones not yet published show under Coming Soon. Full-screen playback is in the player controls. The window needs an internet connection — if the list can't load, Try again retries. You can also watch them on the MoveMatic page.
Canvas
The center of the window is the canvas — a fixed-size scene rendered with whatever's authored at the current playhead. Floating panels (layers, inspector, timeline, scene strip) overlay it as material-backed cards rather than pane splits.
Navigation
- Pan — drag empty canvas with Space held, or two-finger scroll, or drag with the middle mouse button.
- Zoom — pinch on the trackpad, or ⌘+ / ⌘-. ⌘0 fits the whole scene; ⌘1 zooms to 100%; ⌘2 zooms to the selected layer.
- ⌥-drag — duplicate-on-drag. If the drag begins over a layer the selected set is cloned and the copies move with the drag; if it begins on empty canvas it pans.
Selection chrome
Selected layers get an accent-colored dashed bounding box, eight resize handles, and a rotate handle above the top edge. Cropped images and videos wrap the chrome around the visible cropped sub-rect, not the original layer frame.
For freeform / arc / wave lines the rectangular bbox is suppressed in favor of per-anchor endpoint dots (with Start and End labels), which double as drag handles.
Click and drag
- Click on a layer selects it. ⇧-click or ⌘-click extends the selection.
- Click on empty canvas drops the selection. Click-drag from empty space draws a marquee that picks up every layer it touches.
- Click on a selected group, then drag — moves the group. A pure click (no drag) drills into the child under the cursor.
- The body drag is gated by a 4-point arming threshold so a click never accidentally nudges a layer with sub-pixel rounding.
Snap guides
Drag a layer near another layer's edges or center, the scene center, or the scene's edges and a yellow guide line appears with the alignment value. Only layers visible at the playhead are snap targets. Hold ⌘ during the drag to bypass snapping.
Right-click context menu
Right-click anywhere on the canvas to insert layers, paste, group / ungroup, manage z-order, hide / lock, and reach a Select Layer submenu that lists every layer within 20 pt of the cursor (sorted nearest-first). Handy when layers overlap and a regular click would always pick the top-most one — the menu lets you target an obscured layer directly. The bottom of the menu carries Copy Scene Properties / Paste Scene Properties for the active scene (see Multiple scenes).
Layer panel
The Layer panel is the floating card on the upper left. It shows every layer in the active scene as a tree — groups expand into their children — with the Scene pseudo-row at the top.
Rows
Each row has, left to right: indent, disclosure chevron (for groups), kind icon, fill swatch, name, hidden / locked badges, and a timeline-pin "meatball" target.
- Double-click a row name to rename inline. Double-click a group row anywhere outside its name to open or close it.
- Right-click a row for context actions: Rename, Reset Name, Duplicate, Group, Ungroup, Hide / Lock, Reset Timeline, Replace Media…, Delete.
- Hidden layers show an eye-with-slash badge and dim out. Locked layers show a lock badge and reject canvas edits. Click the badge to toggle it back off — un-hide / unlock without going through the context menu.
Scene pseudo-row
The top row labeled Scene stands in for "nothing selected" — clicking it clears the selection so the Inspector pivots to scene-level properties. Its trailing anti-meatball (a slashed dot) unpins every layer's timeline pin in one click. ⌥-clicking the anti-meatball does the opposite — pins every layer in the scene (groups + descendants). Right-click the row to copy the scene's properties or paste them onto it (see Multiple scenes).
Selection
- Click a row to select it. ⇧-click for range, ⌘-click to toggle.
- ↑ / ↓ arrows navigate vertically; ⇧↑ / ⇧↓ extend the selection.
- → / ← expand / collapse the focused group (or step into / out of it when already open).
- Tab cycles selection through siblings at the current depth (root → next root, or within a group's children). ⇧Tab steps backward. Both wrap.
- \ selects the parent of the selection — the group holding each selected layer, or the Scene when the layers are already top-level. Press it again to keep climbing. Works from the canvas and timeline too, whenever no text field is focused.
- Return drills into every selected group at once — expands each, then replaces the selection with the union of all their direct children. Empty groups just expand.
Drag-reorder
Drag any row to a new position. An accent-colored line marks the drop slot. When the dragged row is part of a multi-selection, every selected layer rides along (the payload is newline-separated UUIDs; drops preserve relative stacking).
Pin to timeline
The small dot at the right of each row is the timeline pin. Click it to keep that layer's timeline rows visible even when the layer isn't selected on canvas — handy for editing layer A's timing while picking colors on layer B.
⌥-clicking a group's pin expands the group AND pins every descendant in one click — a fast way to bring a whole folder's timing into view.
Scene strip
The scene strip is a thin band of chips above the timeline showing every scene in the document. Click a chip to jump to that scene; drag to reorder; right-click for Rename, Disable Scene, Move to Embeds, Duplicate, Copy / Paste Scene, Copy / Paste Scene Properties, and Delete. Beside the +, a readout shows the whole document's running time — every scene plus transitions and pauses, exactly as it exports. When a scene is disabled, the full length shows struck through, followed by the length without the disabled scenes. Scenes moved to Embeds sit after the readout under their own label, apart from the video's sequence (see Multiple scenes).
The active scene is highlighted. Transitions are rendered as short connector pills between chips; click one to set its kind (Fade, Slide, Push, Zoom) and duration.
Rename opens a modal sheet — double-click the chip OR pick Rename from the context menu. The sheet's text field is auto-focused with the existing name selected, so you can type to replace. Return commits, Esc cancels. The Inspector's scene-name field is still inline (auto-focused on new-scene creation), so creating a new scene drops you straight into the typing surface.
Timeline
The Timeline panel docks across the bottom of the window. Its content depends on what's selected: nothing selected shows the aggregate tracks across the whole scene; selecting layers reveals their per-layer rows.
Common chrome
- Transport — Jump to start, frame back, play, frame forward, settings, scrubber. Scrubber tracks the playhead live.
- Mute Playback — Timeline → Mute Playback (⌃⌘M), also in the transport's settings popover, silences the audio bed and video sound while you work. Exports keep their audio.
- Timecode readout — shows
seconds · frame/total. - Ripple toggles — two arrow pills floating beside any selected timeline bar / marker, indicating push items before / push items after directions. See Ripple editing.
- Music chip — the document audio bed's filename, with a chevron menu to relink / volume / remove.
Per-layer rows
Each selected (or pinned) layer renders a stack of rows:
- Visibility — colored span bars for every
TimeSpanon the layer. - Video (video layers only) — the clip's scene range, with source-trim handles.
- Pulses (opt-in; appears when a pulse exists) — circular markers with optional duration tails.
- Keyframes — one diamond strip per animated property.
When a group is the sole layer shown, children-aggregate rows appear under it: visibility / video / pulses / keyframes / behaviors / motions scoped to that group's subtree. Empty buckets are hidden.
Inspector
The Inspector is the floating card on the upper right. It always reflects the primary selected layer; multi-selection edits fan out across every other selected layer in the same gesture.
Common rows: Transform (X, Y, Rotation), Size (W, H, Corner radius), Appearance (Fill, Stroke with a solid / dashed / dotted style, Opacity slider, Shadow), Animation (Origin, Cursor override, Motion Trails), plus kind-specific sections (Text font / size / color, Video clip range, Line shape, etc.). Number fields accept arithmetic — type 120+40, 1920/2 or (100-20)*3 and the field evaluates it. Opacity, Blur, and many other scalar rows use a unified slider control (rail + editable value + arrow-step + label scrub).
Multi-select offsets are preserved. Scrubbing or stepping a property with multiple selected layers offsets each one by the same delta from its own baseline. Before scrub: multiple. After scrub: still multiple. Typing a specific value into the field is still a "set them all" action.
Copy & paste a value. Right-click any property's label — Opacity, Fill, Font, a switch, a pop-up — for Copy Value and Paste Value. Paste goes through the row exactly as typing would: it fans across the selection, keyframes the property at the playhead if it's animated, and undoes in one step. Right-clicking a gradient row's label (Fill, Text color, the scene's Background) copies the whole gradient — both colors and the angle — as one set; pasting a gradient onto a solid row turns it into a gradient, and pasting a color turns a gradient row solid. Values also land on the clipboard as plain text (50, #3380FF, linear-gradient(90deg, #3380FF, #F0619E)), so they paste into any text field — and a number or hex color copied elsewhere pastes back in.
Text: font, letter spacing, All Caps. Font is chosen with separate Family and Style pickers. Both are searchable, preview the layer's own text, and work from the keyboard (arrows to move, Return to pick). Letter Spacing adds space between characters (never after the last one) and is keyframable. All Caps renders the text uppercase without changing what you typed.
Text shadows. Text casts a tighter version of the chosen Shadow preset — about a third of the blur and half the drop — so it hugs the letters instead of hazing around the word. With a box fill, the box takes the regular preset and the letters' separate Text Shadow takes the tighter one.
Text: harmonize. A checkbox next to the text-color swatch derives the glyph color as a hue-preserving darker shade of the layer's fill — one-click readable foreground for chip-style buttons. The swatch is disabled (and the cursor flips to 🚫) while harmonize is on; flip it off to set the color directly. Only shows for fills that aren't fully transparent.
Claude Assistant
A second tab on the Inspector hosts an embedded Claude conversation that can read and edit the active scene. Enable it in MoveMatic → Settings → Assistant, paste your own Anthropic API key, pick a model (Opus 5.5, Opus 5, Sonnet 5, or Haiku 4.5), and a "Assistant" segment appears next to "Properties" in the Inspector header. No API key? Use your Claude account instead.
- Ask in natural language. The assistant has tools to read the scene and apply structured patches.
- Each turn lands as a single undoable edit — named after the turn so the undo menu reads "Undo Make every text fill cyan" rather than "Undo Edit."
- Friendly per-tool-call summaries appear in the transcript; "Copy transcript" sends the whole exchange to the clipboard for sharing. Select any part of the chat and press ⌘C to copy just that.
- A Stop button ends a turn that's still running; the next request starts fresh rather than resuming it. Return sends, ⇧Return adds a new line, and the input has its own undo.
- If your API account runs out of credits, the transcript says so plainly instead of showing a raw error.
- Your API key stays in
NSUserDefaultson your Mac and is only sent toapi.anthropic.comwhen you submit a turn.
Use with the Claude app
The MoveMatic skill teaches Claude to read, edit and create .mvm documents, so you can do with your regular Claude account what the in-app assistant does with an API key. Describe a scene, or attach a document and say what to change, and Claude hands back a .mvm file to open in MoveMatic.
Download the MoveMatic skill (zip, free; you don't need a MoveMatic license to use it).
- In Claude, open Settings → Capabilities and turn on code execution. Custom skills need a paid Claude plan.
- In the Skills list there, upload the zip as it is. Don't unzip it first.
- Start a chat and ask for an animation, for example: "Make a 6-second title card for my app Lumen: dark background, the name slides up a letter at a time, then a Get started button pops in and a cursor clicks it." To edit, attach a
.mvmfile and say what to change. - Download the file Claude makes and open it in MoveMatic.
- The skill uses the in-app assistant's own reference: the same document format, effects and layout rules. Claude checks every file against what MoveMatic can open before handing it over.
- Claude can't preview the animation, so it describes what it built as a timeline. Open the file to see it.
- Attached PNG and JPEG images are embedded in the document. Videos and audio stay on your Mac, so Claude leaves those to you.
- Unlike the in-app assistant, Claude can build several scenes at once and set the transitions between them.
- On a Claude Team or Enterprise plan, an admin can add the skill once for everyone in the organization.
- In Claude Code, unzip it into
~/.claude/skills/. Close a document in MoveMatic before asking Claude to edit it in place.
Mix & Match
Select a row of layers and choose Arrange → Mix & Match… (or right-click the selection on canvas). A sheet lets you toggle which property categories to redistribute across the selection — Fill, Stroke Color, Stroke Width, Shadow, Corner Radius, Width, Height, X, Y, Rotation, Font, Font Size, Text Color, Text Content — then commits the whole shuffle as a single undo step.
- Bias slider. All the way left: pure shuffle — values get permuted within the selection, so no new value is introduced. Slide right and each destination layer pulls a fresh value sampled from the pool's min–max range. Useful for "vary these cards a little" vs "completely re-mix them."
- Distribute as set. When on, every enabled property uses the same source layer per destination, so layer A's whole look transfers to layer B in one move. Off: each property is permuted independently — a faster way to feel out unusual combinations.
- Text content pool. Text-content shuffles work off a comma-separated pool. Pre-fills with the current selection's text so you can extend it (add more candidate strings) before committing.
- Discrete properties (Shadow presets, Font names) always shuffle — the bias slider doesn't apply because there's no continuous range to sample from.
Layer kinds
Layers are added from the palette at the bottom-left of the canvas (the "+" button menu) or via the layer panel's "+".
- Rectangle — fill, stroke (uniform or per-side), corner radius, shadow.
- Ellipse — same set as rectangle, no corner radius.
- Text — string, font (PostScript name), size, color, optional bounding box (fill + stroke + corner radius). Sizing picks how the box is sized: Fit hugs the text on one line (plus padding), Auto keeps your width and grows or shrinks the height as the text wraps, and Fixed leaves both to you. Spacing sets letter spacing and Line Height the distance between lines (a multiple of the font's own); both animate.
- Line — multi-shape: freeform polyline with optional Catmull-Rom smoothing and arrowheads; preset closed shapes (square, circle, triangle); preset open shapes (arc, wave). Arc has a bend slider (-10…10) and a length multiplier that scales the curl on long arcs; wave has a frequency / amplitude pair, with frequency snapped to half-cycle increments so both endpoints sit on the layer's midline. Arc bend and wave amplitude scale with the line's width; arc and wave hide their Width / Height fields (the geometry is the length), and converting a line to a circle squares its height to its width.
- Image — PNG, JPEG, HEIC, etc. Imported via drag-and-drop onto the canvas, or via the palette. Supports crop and stroke around the cropped region. A pasted SVG stays vector: it draws sharp at any size, and Burst to Shape follows its own paths.
- Video — H.264 / HEVC / etc. Stored by file URL plus a security-scoped bookmark so a moved file silently relinks. Carries multiple clips per layer, each with its own source range, speed, end behavior, and an optional Freeze Frame mode. See Videos.
- Embedded Scene — one scene from another
.mvmfile, rendered inside the layer's frame exactly as that file would export it, zooms and effects included. It comes in at the scene's own canvas size; when the file has several scenes or alternate layouts, a dialog asks which scene and layout to embed. The inspector picks the scene and layout, refreshes the snapshot from the source file, and sets a Speed (scrub the label or type a percentage, like a video clip's); changing speed stretches or shrinks the layer's timeline bar so the embed still plays to its end. Turn Background off to show only the embedded scene's layers over this one. Edit → Insert Layer → MoveMatic Scene lists this document's own scenes below External File…; an embed of a scene from the same document stays current as you edit that scene, with no need for Update from Source. - Cursor — animated SwiftUI cursor in one of a dozen variants (Arrow, Pointer, Grab, I-beam, etc.) plus a Wait throbber. Treated as an animatable cursor sprite, not an interaction layer.
- Hotspot — invisible rectangle that overrides any cursor layer's variant when the cursor's bbox intersects it. The only "interaction region" kind.
- Zoom — camera viewport. See Camera zoom.
- Group — container with optional auto-layout or 3D perspective. Groups have their own transform, opacity, span effects, and pulses, which compose with their children's.
- Gradient Field — procedural two-color drifting gradient with warp speed and pulse amount; good for backgrounds.
- Particle — region that emits primitives or layer clones. Configurable rate / lifetime / direction / gravity / scale / opacity curves; emits from its own frame OR from any chosen scene layer (line layers contribute curvature). See Particles.
Groups
Select two or more sibling layers and press ⌘G (or Arrange → Group) to wrap them in a group. ⌘⇧G ungroups, baking the group's transform / scale / rotation / layout / pulses into each child so the visual position is preserved.
Grouping is supported at any depth. A group inside a group rotates and scales with its parent; nested children's keyframes, span effects, and pulses all play correctly through the parent chain. The only restriction is that grouping requires every selected layer to share a parent — cross-parent selections disable the Group command rather than silently re-homing layers.
Return on a group selects its direct children. With multiple groups selected, every group expands and the selection becomes the union of all their children.
Size mode
Groups carry a Size Mode toggle in the Layout section:
- Dynamic (default): the group's bounds are the union AABB of its laid-out children. Resizing isn't meaningful — you change child positions or layout to change the group.
- Fixed: the group has its own explicit W and H independent of contents. A purple translucent rect (same vocabulary as a Zoom layer's chrome) appears on canvas with standard 8-corner resize handles. The first flip from Dynamic to Fixed seeds W/H from the current children-derived bounds, so the on-screen rect doesn't jump. A fixed group with a Horizontal or Vertical layout lays its children out inside its rect — see Auto-layout groups.
Fixed groups carry a floating lock pill in the rect's top-right corner. Locked (default): moving the rect moves the children with it — historical group-drag behavior. Unlocked: moving the rect leaves the children where they are, useful for sliding a "viewport" frame around the contents.
Auto-layout groups
Groups have a layout mode in the Inspector — Freeform (default), Horizontal, or Vertical. In Horizontal or Vertical, children are stacked along the chosen axis with a configurable gap, like a CSS flex container. Per-child X (or Y) keyframes are ignored along the laid-out axis; everything else still animates.
Alignment on both axes. Horiz. Align and Vert. Align place the children. Across the layout direction (Vert. Align on a horizontal row, Horiz. Align on a vertical stack) children line up with each other — start, center, or end. Along the layout direction, a fixed-size group places the whole row inside its rect — leading, centered, or trailing (top, middle, or bottom for a vertical stack), centered by default. A dynamic group has no rect to align within, so its row starts where its first child sits and only the cross-axis setting shows.
Reflow. A hidden child, or one outside its visibility spans, gives up its slot and the rest close up around it; as spans open and close, the children slide into their new places instead of jumping.
The layout owns its children's positions, so they don't move when dragged or nudged. Dragging a single child along the row reorders it instead — the others make room as you go. The Layers panel lists these children first to last, in their canvas order (not front to back), and stagger's layer orders and the timeline's canvas sort follow the same order.
Scene layout. The scene itself has the same switch: in the scene Inspector's Layout section, set Horizontal or Vertical and the scene's top-level layers line up in stacking order, placed inside the margin by a Gap and an alignment on each axis (centered by default). Drag a layer to reorder it. In a document with more than one scene the section reads Layout (per scene) — unlike size, margin, frame rate, and background, it's never shared. Cursors, touches, hot spots, zooms, particles, gradient fields and hidden layers keep their own positions.
The groupGap is keyframable, so you can animate cards spreading apart and back together as a single coordinated breathing motion.
3D groups
Turn any group into a 1-point-perspective 3D scene with the 3D toggle in the Inspector's Layout section. Once it's on, direct children of that group gain a Z field in their Transform section — positive Z pushes a child toward the camera (it scales up), negative Z pushes it back. Focal Length (100–3000pt) sets the camera's distance from the group's z=0 plane; smaller values give steeper, more dramatic falloff as children move in Z.
Children also gain Rotation X and Rotation Y — "card tilt" that rotates a child around its own local horizontal or vertical axis, warping it into a trapezoid rather than spinning it flat. Set them as plain scrubbable number fields, same as Rotation. Z, Rotation X, and Rotation Y are all keyframable.
A DoF (depth of field) toggle adds two more sliders: Focus Dist. (the Z depth that's in sharp focus) and Aperture (blur strength per unit of defocus, 0–2). Children near the focus distance render sharp; children further from it blur proportionally, stacking on top of any blur the layer already has.
Selection & reorder
- Marquee — drag from empty canvas to draw a selection rect. Every layer whose AABB intersects gets picked.
- Multi-select duplicate — with multiple layers selected, ⌘D duplicates them all; ⌥-drag clones the whole set.
- Bring forward / send backward — ⌘] / ⌘[. To-front and to-back are ⌘⇧] / ⌘⇧[.
- Align & Distribute — under the Arrange menu. Each acts on the selection set in scene space.
Auto-naming
Rectangles, ellipses, lines, text layers, cursors, and videos auto-name themselves based on a salient attribute and stay synced as you edit:
- Rectangles: "<color> Rectangle" from fill.
- Ellipses: "<color> Ellipse" from fill.
- Lines: "<color> <shape>" from stroke + lineShape (e.g. Coral Wave).
- Text: the first line of the text content.
- Cursors: the variant label.
- Videos: the source filename minus extension.
The moment you type your own name in the inspector or the layer-panel rename field, auto-naming turns off for that layer. Right-click → Reset Name turns it back on and re-derives. The menu item hides itself for shape / line / video layers that are already at their auto-derived default, so the menu doesn't show dead options.
Visibility spans
A visibility span is a time range during which a layer renders. Layers without any spans are visible everywhere by default; the visibility track itself is opt-in and only appears once a layer has at least one span.
- Drag a span's body in the timeline to move it; drag either edge to resize.
- Click a span to surface it in the Inspector as Span on <Layer>, with start / end times and the effect list.
- Add a span from the layer header's + menu → Visibility (disabled when the playhead is already inside an existing span). Adding the first one makes the visibility track appear.
- The aggregate Visibility row collapses spans that share start/end across layers into one bar; dragging it moves every contributing span.
- Hand-offs are clean. A span (or video clip) covers its start but not its end instant, so when one layer's span ends at 16 s and another's starts at 16 s, only the incoming layer draws on that frame. The one exception is an end at the scene's end, which stays visible on the final frame and through the end pause.
- Layers with no authored timeline content (no spans, pulses, motions, behaviors, keyframes, or video clips) get a thin placeholder row so the playhead's vertical line still reaches the layer's space.
Span effects
Each span carries up to one intro effect (plays at the span's start) and one outro effect (plays at the span's end), plus optional secondary effects. They stack — a span with Fade In + Slide In Left as intro will do both simultaneously over the effect's duration.
Available effects
- Fade In / Fade Out — opacity ramp.
- Pop In / Pop Out — overshoot scale spring (0 → 1.08 → 1.0).
- Bounce In / Bounce Out — multi-bounce eased scale.
- Slide In / Slide Out — Left / Right / Top / Bottom, four directions each.
- Type On / Delete Off (text only) — reveal / hide characters from the start.
- Draw On / Erase Off (lines, text and SVG images) — on a line, animate its drawn length. On text and on an SVG image, trace the outline — each letter's contours, each of the SVG's shapes — in the layer's own colors, then fill the layer in over the last part of the effect; Erase Off runs it backwards. A Stagger slider sets how far apart the shapes start (0 traces them all at once, 100% one after another). Merge sets how thin a part has to be to draw as one solid stroke instead of its two edges: Auto draws regular through bold text as strokes, 0 gives an outline look. In an SVG, each shape is judged on its own, and lines drawn with an SVG stroke (line-style icons) trace at their own stroke width, like a pen. Each effect has its own direction toggle (arrow.left.circle / arrow.right.circle in the inspector) — on a line, grow from the end inward or erase from the start; on text and SVGs, trace the last shape first. They're independent. A PNG or JPEG image has no outline, so these effects aren't offered for it.
- Blinking Cursor Start / End (text only) — pulsing caret glyph at the start or end of the typed text.
Group span effects pivot scale / rotation around the laid-out children's content centroid rather than the group's stored origin, so a Pop In on a group expands outward from the visible content's center, not from an off-content reference point.
Text reveal granularity
For text layers, the Fade / Pop / Bounce / Slide effects carry a Reveal picker — Whole (default), Per Character, Per Word, or Per Line — that splits the laid-out text into segments and staggers the effect across them instead of animating the whole block at once. A Stagger slider (0–1) appears once granularity isn't Whole: 0 moves every segment together, 1 sequences them fully, with the last segment always landing exactly on the span's end. (Type On / Delete Off and Draw On / Erase Off are already character- or outline-sequenced and don't offer Reveal.) Reveals and Type On work on text on a path too.
Pulses
A pulse is a one-shot beat at a specific time. The layer plays a short envelope (~1 second) firing one or more of three independent effects:
- Scale — brief size bump (1 → 1.15 → 1) with sine easing.
- Glow — triple-stacked accent-color drop shadow that fades in and back out.
- Radiate — three concentric rings emanating outward from the layer's center, staggered, each with a dark base outline so the rings read on any background. The layer's own silhouette covers its rings; layers below it in z-order get painted over.
Drop pulse markers on the per-layer pulse row, or aggregate across the scene. The inspector lets you toggle each effect, set its trigger time, and (for groups) inherit downward to children.
Keyframes
Every animatable property has its own track and its own diamond strip. To create a keyframe:
- Edit the property in the Inspector; the small diamond next to the field flips to a filled accent color and a keyframe is recorded at the current playhead.
- Or click the diamond directly — it snapshots the current value.
- Or press ⌘K to snapshot every transform / size / opacity property at once. A layer that's already animated gets keyframes only on the properties it animates.
- Or click the keyframe diamond next to the layer's name at the top of the Inspector. It adds keyframes like ⌘K; click again to keyframe every property (the default set plus everything the layer animates), and once more to clear all of the layer's keyframes at the playhead. With several layers selected they cycle together.
Drag a diamond in the timeline to retime; click to select and surface its row in the Inspector with time, value, easing, and wait. Multi-select diamonds with ⇧-click or marquee to retime in bulk.
Reset Property — in the Inspector diamond's menu, or right-click the property's name in the timeline — deletes every keyframe on that property and keeps the value it has at the playhead, so nothing jumps. Behaviors on the property stay put.
Disable Row — right-click a row's name in the timeline (a property, Follow, Visibility or Pulses) to switch the row off without deleting anything. A disabled property holds its static value, a disabled Follow row stops its motions, a disabled Visibility row shows the layer for the whole scene with no span effects, and a disabled Pulses row fires nothing — on the canvas and in export. The row's name is struck through and its items fade, but they stay editable; Enable Row turns it back on.
Animatable properties
X, Y, Z (children of 3D groups), Rotation, Rotation X, Rotation Y (children of 3D groups), Scale X, Scale Y, Opacity, Fill, Stroke, Stroke Width, Width, Height, Corner Radius, Shadow, Cursor variant, Group Gap, Font Size, Font Name, Letter Spacing, Line Height, Text Color, Line Arc Bend, Line Wave Frequency.
Easing
Each keyframe carries an easing curve that governs interpolation into the next keyframe: Linear, Ease In, Ease Out, Ease In/Out, Spring (with stiffness + damping), and Cubic (CSS-style four-point bezier).
The inspector's easing picker fans across the timeline's multi-selection: when every selected keyframe shares a preset the picker shows it; when they disagree the picker shows a blank label, and any selection from the menu writes the new preset to every selected keyframe in one undo entry.
Curve editor
Picking Custom… from the easing preset opens a graphical curve editor inline beneath the picker — a plot with two draggable handles on guide lines from the curve's fixed (0,0) and (1,1) endpoints, quarter gridlines, and a live-redrawn bezier stroke. Handles can be dragged past the plot's edges to author anticipation and overshoot; a compressed head/foot band keeps them reachable without the handle leaving the panel.
Below the plot, quick-pick chips cover Linear, Ease, Ease In, Ease Out, Ease In/Out, Back In, Back Out, plus any curves you've saved as named presets (right-click to rename or delete). The + button saves the current curve as a new preset. Each drag coalesces into a single undo entry.
With a mixed selection of custom curves, the editor shows the primary keyframe's curve as the active line and draws each other distinct curve in the selection as a faint dashed ghost, captioned "Mixed curves — edit or pick to unify." Dragging a handle or choosing a chip applies to the whole selection and collapses it to one shared curve.
Wait keyframes
Each keyframe also carries a wait value: hold the keyframe's value for N seconds after its time before interpolating to the next. Equivalent to authoring a paired keyframe at time + wait, but expressed as a single field so retiming the source diamond pulls the wait along with it.
Visually, waits render as a translucent tail off the right side of the diamond on the timeline.
Behaviors
Procedural property animators that drive a layer's value over a time range without authored keyframes. Add one from the layer header's + menu — each behavior targets a single keyframable property (X, Y, rotation, scale, opacity, font size, line bend, …). Behaviors render as yellow bars on the property's timeline row; drag the body to move, drag an edge to resize.
Four kinds:
- Oscillate — sine wave between a min and a max at a chosen frequency. Min, Max, Frequency. Phase optional.
- Wiggle — smooth random walk (seeded) inside a min–max range. Lower frequencies feel like drift; higher feel like tremor. Reseed from the inspector.
- Spring — settles from the property's value toward that value plus a Target, with Frequency and Damping.
- Ramp — moves the property to its value plus a Target over exactly the bar's length; Curvature bends the line into an ease.
While a behavior's window covers the playhead, the behavior's evaluator wins — keyframes on the same property still resolve at the window's start for the baseline, but the behavior's output is what renders inside the window. Outside the window, keyframes resume.
A behavior's Start & End section sets how it enters and leaves. The start is Tween for a new Oscillate or Wiggle: the behavior eases in from the property's natural value over a short length instead of jumping straight to its first output — which matters most when a row of layers is offset by Phase. Pick Snap for the jump. (Spring and Ramp already start from the natural value, so they show only End.) The end is Tween for a new behavior (ease back to the property's natural value over a duration), Stick (hold the behavior's last value), or Snap (hand back to keyframes at once).
For behaviors targeting X, Y, Rotation, Scale X, Scale Y, or Text Color on a text layer, a Per Segment section — first in the behavior's settings, since it changes what the rest mean — adds a Split picker — Whole, Per Character, Per Word, or Per Line — plus a Stagger slider. Splitting turns a single Oscillate or Wiggle into a phase-offset ripple across the text; on Spring it reads as a staggered arrival per segment. Split position and rotation are offsets from each segment's own place: X and Y show a single Distance (how far either side to swing), and rotation's range adds to the layer's own rotation.
X and Y behaviors also become offsets where something else places the layer — a laid-out group's slot or a Follow Path route — so the layer wiggles or bobs around that place instead of being pinned to fixed coordinates.
Motions
Layer-level animators that move the whole layer over a time range. Added from the layer header's + menu. Motions render as orange bars on a dedicated per-layer Motion row.
- Follow Layer — attracts the layer's position toward another scene layer's center over the motion's window. Pick the target via the layer picker. Optional orbit-on-arrival keeps it circling once it's close. The aggregate Follow row shows fused bars. The follower lands with its Origin on the target; a cursor lands by its tip instead — and by the tip of the cursor it's drawn as on arrival, so a target with a Pointer hover override gets the hand's fingertip, not the arrow's.
- Follow Path — moves the layer along a chosen line layer (freeform, arc, wave, circle, square, triangle). Knobs:
- Ping-pong with a cycles count (0.5 increments, so a single return is 0.5).
- Loop (closed shapes only) — mutually exclusive with ping-pong.
- Tilt — rotate the layer to match the path's tangent.
- Tilt per-letter (text layers) — each glyph rotates to the tangent at its own arc position.
- Upright letters — flip glyphs that would otherwise read upside-down on a steep tangent.
- Baseline (per-letter) — how far the letters' baseline sits from the stroke: 0 sets the text on the line, positive lifts it off, negative sinks it below. Letters are spaced evenly along the curve their centres ride, so they don't fan apart over a crest or crowd into a trough, and kerning pairs stay together. Per-segment behaviors and reveals play on the letters too.
Motions claim their target properties (X, Y, plus rotation when Tilt is on) for their window, the same way Behaviors do — keyframes on those properties are bypassed inside. On Follow Path, X and Y behaviors still apply, added on top of the route.
Target picker & end state. A follow's target rows are labeled Target Layer (Follow Layer) and Target Path (Follow Path), and a layer is excluded from its own picker. Each follow ends with a chosen end state — by default Stick, which holds the followed position once the window ends. Follow Path leads with a Transition to Start duration that eases the layer onto the path before the path motion begins (hidden when the entry mode is Snap).
Follow Layer on a text layer adds a Fly In picker (Whole, Per Character, Per Word, Per Line) with its own Stagger slider, so characters, words, or lines can converge on the target one after another instead of arriving as one rigid block. Fly In doesn't apply to Follow Path.
Motion trails
Turn on Trails in the Inspector's Animation section and a moving layer leaves a short series of fading ghost copies at its recent positions — a motion-blur-style echo that traces the path of the motion. Enable it on a group and the whole composite trails together. Trails render identically on the canvas and in exported MP4 / PNG output, and are purely visual: they add no layers and don't affect hit-testing or selection.
Particles
A particle layer is a region that spawns rendered particles over time. Inspector sections:
Shape
The rendered primitive per particle — Circle, Square, Triangle, Diamond, Pentagon, Hexagon, Star, Ring, plus the option to Choose Layer… and clone one of the scene's own layers (text glyph, an image, a shape, a group) as the particle shape. Cloned particles inherit the source's full rendering.
Emitter
A single menu defining where particles spawn:
- Rectangle / Ellipse / Border / Point — emission shape inside the particle layer's own frame.
- Choose Layer… — pick any other scene layer as the emission source. The particle layer's bbox binds 1:1 to the chosen non-line source. For line sources the polyline is sampled at 200 evenly-spaced u-values so the cloud hugs the actual stroke (freeform curves, arcs, waves, circles all supported). An inline x next to the menu clears back to in-layer mode.
Burst to Shape
The Emission group's mode switches from Continuous (a steady stream at a Rate) to Burst to Shape: at the start of each visibility span the emitter releases one particle per point along a Target layer's outline — text glyphs, a line or path, a rectangle or ellipse, an image's alpha edge, or a group's union of those. Each particle flies out from the emitter to its point, holds there, then gravity, drift, and turbulence take it. Spacing sets the distance between points (so density holds when the target is resized or retyped), Flight and Flight ± how long the trip takes, and Hold how long the shape stays formed. Give a layer several spans to fire it several times — fireworks that spell out a word are one particle layer per burst.
Emission, Motion, Life curve, Render
- Rate + Lifetime.
- Speed, Speed ±, Direction, Direction ±, Gravity.
- Rotation start, Rotation ±, Angular velocity.
- Scale start / end, Opacity start / end.
- Blur per-particle gaussian, Seed (re-rollable).
- Tint gradient — sample each particle's color from a gradient across the emitter, projected onto a chosen angle.
- Start color — optional color each particle is born with, fading into its tint over the first Fade percent of its life (a firework's white-hot flash).
- Clip to Frame — when on (default), particles can't render past the particle layer's bbox. Off lets them drift indefinitely on velocity / gravity.
Aggregate tracks
With nothing selected, the timeline renders collapsed rows across every layer in the scene — one per track type that has any content:
- Visibility — bars sharing the same (start, end) across multiple layers fuse into one. Dragging a fused bar moves every contributing layer's matching span by the same delta.
- Video — one bar per clip across every video layer (multi-clip layers contribute multiple bars). Grouped video layers fold in too.
- Keyframes — diamonds at every unique time; a marker showing how many layers' keyframes share that time.
- Pulses — markers at every unique time.
- Behaviors — fused yellow bars when multiple layers' behaviors share a (start, end). Same drag / trim / ripple semantics as the visibility aggregate.
- Follow (motions) — fused orange bars across layer-level motion ranges.
Clicking a fused marker opens a small popover listing each contributing layer so you can drill in. When a single group is the timeline's sole layer, the per-layer rows are followed by these same aggregate rows scoped to its children's subtree — visibility, video, keyframes, pulses, behaviors, and motions all participate.
Timeline selection
Spans, pulses, keyframes, and video clips are independently selectable on the timeline. Click for single, ⇧-click for additive, marquee for batch. The selection drives:
- Inspector contents (single span → span editor; single keyframe → keyframe row; multi → bulk-edit mode).
- Delete behavior (⌫ removes every selected item).
- Ripple anchor (the dragged item's original position seeds the snapshot — see Ripple).
Right-click the select button at the playhead to select every item of one kind — all spans, all keyframes, all pulses and so on.
Snapping
Drag-snap is split into two layers, both configurable from the timeline's settings sheet:
- Grid increment — quantize every drag to a chosen step: Frame, 0.1s, 0.25s, 0.5s, or 1s.
- Proximity targets — toggles for "also snap to" the playhead, visibility / video span edges, keyframes, and pulses. Anything within ~6 px of the cursor's quantized position pulls it onto the target time.
Snapping only considers items the timeline is showing: the selected or pinned layers' own items, everything inside a shown group (its Children rows), or the whole scene when nothing is selected. Items being dragged never attract themselves. The playhead follows the same rule when you scrub.
Hold ⌘ during a drag to bypass snapping entirely for fine adjustments.
Set In / Set Out
With one or more spans (or video clips) selected on the timeline:
- I — set each selected item's in (start) to the current playhead. If the playhead is past the item's end, the whole item slides instead of inverting.
- O — same, but for the out (end).
Both honor the current ripple toggles: with ripple on, the trim's delta cascades through every captured before / after item the same way a body drag would, and the "Ripple moved N items" toast fires so the silent shift is visible.
Ripple editing
Ripple mode shifts the rest of the scene's timeline content by the same delta as the primary drag, like a tracking shot. The two toggles — push items before and push items after — pick which side of the dragged item's anchor goes along for the ride.
- R cycles the toggles: off → before → after → both → off.
- Direction pills appear on any selected timeline bar / marker once a ripple direction is on, so you can see at a glance what's coming with you.
- Ripple applies to every drag and every trim (span body, span edge, pulse marker, keyframe, video clip; I / O; the Move / Distribute / Expand / Contract / Retime modals).
- Items pushed past the timeline's duration extend the scene to fit; pulled back inside the original duration shrink it back to where it was at drag-begin (never below).
- The captured anchor is the dragged edge's original time, so trimming a span's left edge ripples the items before that edge (with push-before on); trimming the right edge ripples items after the new right edge.
Move, Expand / Contract & Retime
A group of batch modal sheets under the Timeline menu: Move… (⌘⇧M), Distribute… (⌘⇧D), Expand / Contract… (⌘⇧E), and Retime…. Each previews its result non-destructively on the real timeline as you adjust, and commits as a single undo step — Cancel restores exactly what was there before.
- Move… — shift every selected item by a delta (typed in seconds) or to a snap target (the playhead, a specific time, the earliest item's start).
- Expand / Contract… — scale every selected item's time around an anchor (the selection's start, center, or end), optionally stretching item lengths along with the gaps. Useful for "make this whole intro 30% faster" without retouching each keyframe. (Formerly "Dilate.")
- Retime… — a table of every selected item with editable Start and Duration fields; rows reorder live as their timing changes, and the whole set applies at once when you click Retime.
All honor ripple toggles — non-selected items shift to keep the rest of the scene aligned with the user's edit. The toggles ARE the global Push Before / Push After; flipping them inside a modal flips them everywhere else, and vice versa.
Distribute
Kind-agnostic — pick 2+ timeline elements of any mix (visibilities, video clips, keyframes, pulses, behaviors, motions) and choose Timeline → Distribute… (⌘⇧D). One sheet, two modes:
- Sequential lays the items end-to-end from the earliest start, separated by a chosen gap — a staircase of bars or beats.
- Cascade fans the items out from a common start by a chosen amount, with a spacing curve to spread or compress the gaps.
Order sets the sequence in both modes: Layer top → bottom and Layer bottom → top follow the layer list (a layer's own items by start time), By start time keeps the order they already play in, and Random shuffles — once per opening, so the preview and the result agree. The sheet's Now / After preview lists the selection's tracks in layer order and scrolls when there are more than fit.
Like the other batch sheets, Distribute previews on the real timeline, runs as a single undo step, and respects the global ripple toggles for items outside the selection.
Timeline zoom
The timeline cycles between three zooms — fit all (1×), 4×, and 8× — via the Z keyboard shortcut. The 4× and 8× modes show a context minimap above the tracks for navigation across the larger-than-window timeline.
- Toggle via the magnifier in the timeline toolbar, or with Z.
- While zoomed in, two-finger horizontal scroll pans the visible window; the minimap shows where it sits in the full scene.
- The minimap's window can be dragged or its edges resized to move / zoom the viewport.
Multiple scenes
A document can hold any number of scenes. Each scene has its own size, frame rate, duration, background color, start- and end-pause (holds of the first frame before the timeline animates and the last frame after it runs out), and layer tree. Duration and the pauses live in a popover on the timeline's timecode readout — click the timecode to open it, and drag the Duration label to scrub it.
- Shared settings — the Shared switch at the top of the Scene inspector keeps size, margin, frame rate and background the same in every scene. Turning it on gives every scene the current scene's settings; after that, editing any scene's updates them all. Duration and pauses stay per scene.
- Disable a scene — right-click its chip → Disable Scene. It stays in the document and stays editable, but Play All Enabled Scenes skips it, All Scenes exports leave it out, and the audio bed lines up as if it weren't there. Exporting it by name still renders it. The chip shows it struck through.
- Embeds — right-click a chip → Move to Embeds to keep a scene only for embedding in other scenes: a logo sting, a lower third. It moves to its own list at the end of the scene strip and, like a disabled scene, is left out of Play All Scenes, whole-document exports, the running time and the audio bed; it has no transitions. Exporting it by name still renders it, and Edit → Insert Layer → MoveMatic Scene lists embeds first. Move to Sequence puts it back at the end of the video. Chips reorder within their own list.
- Layers in every scene — turn on All Scenes in a top-level layer's Animation section to keep it in every scene: it's copied into each one, and an edit to it in any scene applies to all of them. A stack badge marks it in the layer list. Turning it off keeps it in the current scene only. Its spans and keyframes play on each scene's own clock, so a shared layer is best left always visible or animated with behaviors. See Scene transitions for how it behaves at a cut.
- Add scene — ⌘⇧N, the "+" on the scene strip, or Scene → New Scene.
- Duplicate active scene — Scene → Duplicate. Adds " Copy" to the name and inherits size / fps / duration / background from the source.
- Delete — right-click a scene chip → Delete. A document always keeps at least one scene.
- Reorder — drag scene chips. Playback follows array order.
- Rename — double-click a chip's title. Empty names fall back to Scene N.
- Copy / paste scene properties — right-click a scene chip, the layer panel's Scene row, or the canvas and pick Copy Scene Properties. That captures the scene's size, frame rate, duration, start / end pause, Fit mode, margin, background (solid or gradient) and transition — not its name or layers. Paste Scene Properties applies them to one scene; Paste Scene Properties to All Scenes applies them everywhere in one undo step. A size change pins content to the Anchor grid, the same as typing the size. Works across documents.
- Resize the canvas — Width and Height in the Scene inspector, or the Preset menu. The 3×3 Anchor grid beneath them picks the point the content stays pinned to: top left (the default) leaves every layer where it is, center grows or trims the canvas evenly on all sides, and so on. Top-level layers, their X/Y keyframes and Attract / Orbit targets all shift together; layers inside a group move with their group.
Scene transitions
Between any two adjacent scenes you can drop a transition. Click the connector pill between scene chips to open the transition picker.
- Fade — cross-fade between the outgoing last frame and the incoming first frame.
- Slide Left / Slide Right — outgoing scene slides off in the chosen direction.
- Push — outgoing pushes out as incoming pushes in (matched motion).
- Zoom — outgoing scales out while incoming scales in.
- None — hard cut.
When both scenes have the same background — always the case with the scene Inspector's Shared switch on — the background stays still and only the layers fade, slide, push, or zoom.
Layers with All Scenes on hold still too: they're drawn once, outside the transition. One at the very bottom of the layer list stays behind the moving layers (a backdrop glow, a gradient field); any other is drawn in front of them (a logo, a progress bar).
Duration is configurable per transition. A scene's endPause field lets you hold the last frame for an extra N seconds before the transition starts — useful for letting a finished animation breathe.
Alternate layouts
An alternate layout is another version of the whole document at a different size — a 9:16 story, a 1:1 square — that stays in sync with the main layout. Every scene, layer, animation and timing edit you make in the main layout shows up in every alternate layout. A layout only stores what's different about it.
- Create one — the layout menu above the canvas → New Layout…. Name it and pick a preset or type a size. The menu switches between layouts, renames them (the main layout can be named too and always shows (Main)) and deletes them. While an alternate layout is active the area around the canvas is tinted.
- What a layout can change — each scene's canvas size and margin, and each layer's position, scale, media and visibility. Everything else — adding, deleting, restyling, retiming, renaming — belongs to the main layout, so those actions are unavailable in a layout and the timeline tracks are locked (the playhead still scrubs).
- Auto — repositions layers proportionally so they fit the layout's canvas, and keeps doing so as the main layout changes. Scale — Fit or Cover scales every layer by one amount to suit the canvas. Whatever you then move or resize by hand sits on top.
- Moving and resizing — drag, nudge or use the Layout panel's Offset fields; an animated layer moves its whole path. Resize handles scale the layer, so text, strokes and images grow together. Text instead gets its own box width per layout (a share of the canvas width) and rewraps; Fit and Auto text keep their height following the wrap. A zoom layer's scale re-frames the shot.
- Media — an image or video layer can use different media in a layout: the Layout panel's Media row → Replace… (or its arrow → Replace with Clipboard), or Replace Image/Video in “Layout”… in the layer's right-click menu, on the canvas or in the Layers panel. The layer keeps the main layout's frame and timing; media of another shape is fit inside that frame rather than stretched, with corners, stroke and shadow following the media.
- Visibility — Hide / Show while a layout is active hides or shows the layer in that layout only, so a layer can be in one layout and not another (or hidden in the main layout and shown in one layout). A layout-only hide shows its badge in the Layers panel in your accent color; setting the layer back to its main-layout state makes it follow the main layout again.
- Reset to Main Layout clears a layer's offset, scale, text box and media in the current layout.
- Export filenames carry the layout's name — including the main layout's, once the document has alternates.
- Export — pick a layout in the export sheet, or All Layouts. Quick Render previews the layout you're viewing.
Audio bed
A document can carry one continuous audio track that plays across every scene during preview and is muxed into the exported MP4. Set it via Scene → Document Audio… or the music chip on the scene strip.
- Pick any audio file (MP3, AAC, M4A, WAV). A security-scoped bookmark is stored alongside the path so moved files silently relink.
- Volume is per-document, 0…1.
- The track auto-fades over the last second of the final scene so exports don't end with an abrupt audio cut.
Images
Drag any image file onto the canvas to add it. Multi-drag drops every file at once, fanned out by 20pt down-right so they don't all land on the same pixel.
- Image bytes are inlined into the
.mvmdocument on save — there's no relink dance for images. - Layer size on add defaults to the source's natural pixel dimensions, capped at 600pt on the long edge.
- Stroke around the image follows the cropped (visible) region, not the original layer frame.
- Right-click (on the canvas or in the Layers panel) → Replace Image… swaps the source without disturbing the layer's transform, animations, or selection. If the new image has a different aspect a dialog asks whether to keep the layer's current frame or resize to the new natural aspect. When the clipboard holds an image, Replace with Clipboard… appears beside it (and in Edit) and does the same with that image.
Videos
Pick a video file via the palette or drag-drop it. MoveMatic supports anything AVKit can decode (H.264 / HEVC / ProRes / etc.).
Multiple clips per layer
A video layer holds a list of video clips — each clip places a portion of the layer's source on the scene timeline at its own start / end, with its own trim, speed, and end behavior. The Video row renders one bar per clip; all bars share the layer's single source file.
- Add Clip — the + in the row gutter adds a clip from the playhead to scene end (or from
0when the playhead is already inside another clip). Right-clicking the row also exposes Add Clip. - Duplicate Clip — right-click a clip → Duplicate. Clones with a fresh id, shifted right by the original's length so the two don't overlap.
- Split at Playhead — right-click a clip → Split at Playhead (also in the menu, for a selected clip — including one inside a group). The second half picks up at the source frame under the cut so the cut is seamless, and both halves get matching trims: cut inside the played footage and each half keeps its own loop / freeze tail; cut in a freeze tail and the second half becomes a still of the held frame.
- Delete — right-click → Delete, or select the clip and press ⌫.
- Newly added or duplicated clips are auto-selected so the inspector dives straight into the new clip's properties.
Source vs scene time
Each clip carries a source range plus a scene range. Dragging the bar's body moves the clip in scene time; dragging the left edge trims into the source; dragging the right edge truncates the rendered length. Clips snap to the standard timeline targets (other clips' edges, span edges, keyframes, pulses, playhead).
Trim sheet
Click Trim… in the video clip inspector to open a dedicated trim sheet — the one place a clip's in and out points are set:
- A 24-thumbnail filmstrip and a large preview pane that keeps the source's own aspect ratio (portrait recordings are letterboxed, not squashed).
- Frame-precise In and Out integer-frame fields with ↑ / ↓ stepping (⇧ × 10) and a total-frame readout.
- Drag either yellow handle to move that endpoint; drag the body in between to translate the whole range — a dashed white ghost of the original range stays visible and the leading / trailing edge snaps back to either ghost endpoint (4 candidates, nearest wins within ~14 px). The snap fires a cyan highlight on the ghost.
- Hover playhead — moving the cursor over the strip without clicking shows a thin cyan playhead and live-scrubs the preview to that source frame.
- I / O set In / Out at the cursor's current source-time (hover position when hovering, otherwise the last-touched handle). They override even a focused frame field — the field commits its pending edit, then the action lands.
End behavior
When scene time runs past the source's natural end, the clip can:
- End — go blank (the clip's outpoint stops playback).
- Loop — wrap modulo the source duration.
- Freeze Frame (end) — hold the last frame.
- Loop Back and Forth — ping-pong the source.
Freeze Frame mode
The clip inspector's Mode toggle flips between Video (normal playback) and Freeze Frame. When Freeze Frame is on, the trim / playback / end-behavior knobs disappear and the inspector shows a mini-filmstrip, a large preview, and an integer-frame input. The chosen frame renders for the entire span — extend the clip's right edge indefinitely past the source duration and it stays held. Useful for "card holds" between cuts.
Speed
Each clip has a Playback Speed field (0.01% – 10000%), with a % / s toggle to set it instead as the clip's play length in seconds. Scrub the label or arrow-step the field by 1% (⇧ × 10, ⌥ ÷ 10). The bar in the timeline rescales so the rendered duration always matches the trimmed source ÷ speed, and a loop / freeze clip's hatched tail moves with it — the trim is measured in source seconds, so it lands at trim ÷ speed on the bar.
Relink & missing sources
Video files are referenced by file URL + security-scoped bookmark. If a file moves, MoveMatic silently relinks via the bookmark on next open. A video that iCloud has evicted downloads in the background while a placeholder stands in, and a video still syncing into a cloud folder counts as downloading rather than missing. If a file is genuinely gone, the layer shows a striped placeholder ("Video missing") and the layer panel's right-click menu surfaces Replace Video… to point at the new location.
Audio
Each video clip carries its own audio that's muxed into the exported MP4 alongside the document audio bed, at the clip's scene timing.
Stroke
Videos accept the same stroke options as images — color, width, position (inside / outside), per-side widths. The stroke wraps the visible cropped region, with rounded corners matching the layer's cornerRadius.
Cropping
Images and videos both support cropping via the Crop toggle in the Inspector.
- Off — the source fills the layer frame.
- Auto (legacy / video-only) — detect a black-keyed source window and mask everything else to transparent. Insets X and Y let you tune the detected bbox.
- Manual — open the Crop editor by clicking Edit Crop…. A modal sheet shows the source at native resolution with eight handle controls; drag handles to set the crop rectangle, arrow keys to nudge by one pixel (⇧ = ten), Auto snaps to a detected source window, Reset drops the crop back to identity. Esc cancels; ⌘Return commits.
While you nudge a handle with the arrow keys, a square pixel-accurate loupe appears in the middle of the crop area, magnifying that handle's edge so the source's actual pixels are visible without resampling. Dragging, or clicking anywhere off a handle, hides it. ⌘Z / ⇧⌘Z inside the editor step through its own crop history and never touch the document behind it; nothing is applied until you click Done.
After a manual crop the inspector's X / Y read the visible top-left position rather than the underlying layer-frame top-left, and the 3×3 origin grid maps cells to the visible cropped sub-rect's corners / edges / center. Selection chrome, the stroke, and the rounded mask all line up with the visible content.
Camera zoom
A Zoom layer is a camera viewport — for the duration of its visibility span, the rendered scene "lenses into" the layer's rectangle.
- Full screen mode: the whole canvas zooms into the rectangle. Use for hero-shot moments — drop a zoom layer over a single button at the end of an animation and the playback gracefully closes in on it.
- Picture-in-picture mode: the captured rectangle is rendered into a child rect somewhere else on the canvas, like a sticky note showing a detail from another part of the scene. The child rect is its own layer with its own transform, animations, span effects, and pulses.
- Zoom span edges carry their own start / end transition picker: a smooth animated zoom-in, a fade, or a hard cut on each side independently, with a length field for each.
- Zoom layers are invisible at edit time except for their outline, drawn two-tone so it shows on any content; during playback / export they're consumed entirely. Click the outline to select a zoom, then drag it from anywhere inside. Clicks inside an unselected zoom go through to the layer behind it.
Export to MP4
File → Export… (⌘E) opens the export sheet.
- Layout (documents with alternate layouts) — the main layout, any alternate layout, or All Layouts, which asks for a folder and exports every layout into it, one after another, each file named after its layout.
- Target — Current Scene, All Scenes (joined by transitions), All Scenes (Separate Files), or a specific scene by name. Separate Files asks for a folder and writes each scene into it as its own clip, named after the scene — handy for handing scenes to an editor as discrete pieces. With a scene disabled the whole-document targets read All Enabled Scenes / All Enabled Scenes (Separate Files) and leave it out. The last choice is remembered.
- Output filename — defaulted from the document name + target.
- Frame rate — 60 fps or 30 fps, applied to every exported scene. 60 plays smoothest; 30 renders in half the time and makes smaller files. The last choice is remembered.
- Motion blur samples — Off, Light (4×), Medium (8×), Strong (16×). Each sample is rendered at a different sub-frame time and averaged. The renderer also skips the blur pass on frames where nothing actually moves during the shutter window, so long static stretches export at single-frame speed regardless of the setting.
- Size — Full, 75%, Half, or Quarter of the scene's pixel dimensions. Smaller renders faster — useful for checking motion and timing without waiting for a full-resolution export.
- Include audio — toggle the document audio bed + every video clip's audio into the muxed output. A movie that ends up with no sound still gets a silent audio track, since some upload tools (app previews among them) reject a movie with none.
- Transparent — export a
.movwith an alpha channel and no scene background, for compositing over other footage. An Alpha Codec menu picks ProRes 4444 (lossless, large, broadest editor support) or HEVC (smaller) (plays in QuickTime and Safari; some editors can't import it). Motion blur is skipped.
Export is non-blocking — a progress sheet shows percentage, current frame, and a live preview snapshot updated every ~10Hz. Cancel via the sheet's Cancel button or Esc.
The rendered MP4 matches the live canvas pixel-for-pixel: same layer kinds, same span effects, same pulses, same scene transitions, same zoom-camera mapping. If there's a visible difference you found a bug — file it.
Keyboard shortcuts
File & document
| Shortcut | Action |
|---|---|
| ⌘N | New document |
| ⌘O | Open document |
| ⌘S | Save |
| ⌘⇧S | Save a copy |
| ⌘W | Close window |
| ⌘E | Export MP4 |
| ⌘Z / ⌘⇧Z | Undo / Redo |
Canvas
| Shortcut | Action |
|---|---|
| ⌘+ / ⌘- | Zoom in / out |
| ⌘0 | Fit scene to canvas |
| ⌘1 | Zoom to 100% |
| ⌘2 | Zoom to selected layer |
| Space drag | Pan |
| ⌥ drag | Duplicate-on-drag (over a layer) / Pan (empty space) |
| ⌘ drag | Bypass snapping |
| ⇧ drag | Constrain motion to a single axis |
| ↑ / ↓ / ← / → | Nudge selection by 1pt (⇧ = 10pt) |
| L | Toggle aspect lock on width / height |
| \ | Select the parent group (or the scene) |
| ⌫ / Delete | Delete selection |
Selection & layers
| Shortcut | Action |
|---|---|
| ⌘A | Select all layers in active scene |
| ⌘D | Duplicate selection |
| ⌘G / ⌘⇧G | Group / Ungroup |
| ⌘] / ⌘[ | Bring forward / Send backward |
| ⌘⇧] / ⌘⇧[ | Bring to front / Send to back |
| ↑ / ↓ (layer panel) | Navigate rows (⇧ = extend) |
| → / ← (layer panel) | Expand / collapse group (or step into / out of) |
| Tab / ⇧Tab | Cycle through siblings at the current depth |
| Return | Drill into every selected group (selection becomes their children) |
Timeline
| Shortcut | Action |
|---|---|
| Space | Play / Pause |
| ← / → (timeline focus) | Step one frame back / forward |
| ⇧← / ⇧→ | Step 10 frames back / forward |
| Home / End | Jump to scene start / end |
| ⌘K | Snapshot keyframes for every transform / size / opacity property at playhead |
| I / O | Set In / Set Out on every selected span / video clip (honors ripple) |
| R | Cycle ripple direction: off → before → after → both → off |
| Z | Cycle timeline zoom: 1× → 4× → 8× → 1× |
| I / O (Trim sheet) | Set In / Out at the trim sheet's cursor source-time — overrides focused fields |
| ⌘ drag | Bypass timeline snapping |
| ⌘⇧M | Open the Move… modal |
| ⌘⇧D | Open the Distribute… modal |
| ⌘⇧E | Open the Expand / Contract… modal |
Scenes
| Shortcut | Action |
|---|---|
| ⌘⇧N | New scene |
| ⌘⇧→ / ⌘⇧← | Next / previous scene |
Languages
MoveMatic is localized into English, Deutsch, Español, Français, Italiano, Nederlands, Polski, Português (Brasil), Українська, 日本語, 한국어, 简体中文, and 繁體中文. It picks the right language automatically based on your System Settings → General → Language & Region preferences.
To pin MoveMatic to a specific language without changing system preferences, open System Settings → General → Language & Region → Applications, click the + button, and pick MoveMatic.
Documents created in a non-English locale also auto-name their scenes and layers in that language — Szene 1, 사각형 1, Ellisse 2 — so the layer panel reads naturally instead of dropping back to English defaults. Renamed layers persist as you typed them across locale changes.