Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ter-9001/WannaCut/llms.txt

Use this file to discover all available pages before exploring further.

WannaCut’s editing model is non-destructive: clips on the timeline are lightweight references to source assets. Trimming a clip never touches the original file — it only adjusts the clip’s beginmoment (where playback starts within the source) and duration (how many seconds of it play). You can always extend a trimmed clip back to its full source length at any time.

​
Trimming with Drag Handles

Every clip on the timeline has a 1.5 px resize handle on its left edge and its right edge. Hover over either edge until the cursor changes to a horizontal resize arrow, then drag.

​
Right-edge trim (adjust duration)

Dragging the right handle changes only the clip’s duration. For video and audio clips, the maximum you can expand is bounded by how many seconds remain in the source file after the current beginmoment. For image clips, there is no source-file limit — images can be extended indefinitely (until the start of the next clip on the same track).

​
Left-edge trim (adjust start and beginmoment simultaneously)

Dragging the left handle performs a two-property update:
  • start — the clip’s position on the timeline moves right or left.
  • beginmoment — the playback entry point into the source asset shifts by the same amount, so the content visible at the playhead remains in sync.
Left-edge expansion is bounded by two limits, whichever is smaller:
  1. Timeline boundary — the clip cannot move earlier than the end of the previous clip on the same track.
  2. Asset boundary — the clip cannot reveal source content before frame zero (for video/audio). Images have no asset boundary and can expand freely to the left.
A minimum duration of 0.1 seconds is enforced on both edges to prevent clips from disappearing entirely.

​
Fade In / Fade Out

Each clip has two small corner drag handles at the top of its body:
  • Top-left corner → Fade In duration (stored as fadein for video opacity, fadeinAudio for audio).
  • Top-right corner → Fade Out duration (stored as fadeout / fadeoutAudio).
Drag either handle horizontally to set the fade length. The engine applies different curves depending on track type:
  • Video fades — linear opacity ramp from 0.0 to 1.0 (or vice versa).
  • Audio fades — logarithmic dB attenuation using the formula 20 × log₁₀(progress), matching the natural loudness perception of the human ear. At fadeModifier = 0 the volume floor is set to −100 dB (digital silence).

​
Splitting Clips (Alt+S)

Place the playhead at the exact frame where you want to cut, then press Alt+S (or click the Scissors button in the toolbar). The split logic works as follows:
  1. WannaCut collects every clip whose range contains the playhead.
  2. If a clip is selected and it is under the playhead, that clip is split. The selected clip takes priority even when others overlap.
  3. If no clip is selected and exactly one clip is under the playhead, that clip is split automatically.
  4. If no clip is selected and multiple clips are under the playhead, WannaCut shows a “Multiple clips found! Select one to split.” notification and waits for you to make a selection.
  5. After the split, the right portion is auto-selected so you can immediately move or delete it.
Internally, splitting produces two new clip objects: 
// Left portion — same start, shortened duration
const firstClip = { ...original, duration: timeOffsetFromClipStart };

// Right portion — starts at playhead, shifted beginmoment
const secondClip = {
  ...original,
  id: crypto.randomUUID(),
  start: playheadTime,
  duration: original.duration - timeOffsetFromClipStart,
  beginmoment: original.beginmoment + timeOffsetFromClipStart
};

​
Split & Select Left / Right

These two commands combine a split at the playhead with a bulk selection — ideal for deleting or moving an entire half of a timeline in one action.
ShortcutAction
Ctrl+QSplit every clip under the playhead, then select all clips that end at or before the playhead.
Ctrl+WSplit every clip under the playhead, then select all clips that start at or after the playhead.
After the command, use Delete or Backspace to remove the selected half, or drag any selected clip to reposition the entire group.

​
Moving Clips

Drag the body of any clip to reposition it on the timeline. You can drag:
  • Horizontally — changes the clip’s start time.
  • Across tracks — drops the clip onto a different track. If the target track type is incompatible with the clip’s media type (e.g., dropping a video clip onto an audio track), a new track of the correct type is created automatically.
If the drop position on the target track is already occupied, WannaCut finds the next unoccupied track of the same type rather than overlapping clips.

​
Magnetic Snapping

Press Ctrl+T to toggle Magnetic Snapping on or off. A notification confirms the new state (Magnetic Snap: ON / OFF), and the snap icon in the toolbar pulses red while active. When snapping is enabled and you drag a clip, WannaCut checks only the immediate left and right neighbors on the same track — not distant clips — keeping snapping predictable and preventing clips from jumping across the timeline:
  • The end of the left neighbor becomes a snap candidate.
  • The start of the right neighbor becomes a snap candidate.
The engine picks whichever candidate is closer to the dragged clip’s current position. If the clip has no neighbors, snapping is a no-op.
Use Ctrl+. (period) and Ctrl+, (comma) to jump the playhead forward and backward between cut points without leaving the keyboard. This is the fastest way to review every edit in sequence after a batch of splits.

​
Multi-Select

Select more than one clip at a time using any of these methods:
  • Shift+Click or Ctrl+Click — adds individual clips to the current selection.
  • Box selection — click and drag on any empty area of the timeline to draw a selection rectangle. All clips that intersect the box are selected when you release.
Once multiple clips are selected, dragging any one of them moves the entire group together, preserving relative spacing between clips.

​
Copy & Paste

ShortcutAction
Ctrl+CCopies all currently selected clips to the internal clipboard.
Ctrl+VPastes the copied clips at the current playhead position.
Paste preserves the relative timing between clips in the copied group. The leftmost clip in the group is anchored to the playhead; all others are offset accordingly. If the target track is already occupied at the paste time, WannaCut increments the track ID until it finds a free slot, creating a new track if necessary.

​
Deleting Clips

Press Delete or Backspace to remove all currently selected clips from the timeline. The underlying source assets are not affected — the files remain in the videos/ folder and in the Media Library.
Clip deletion, splits, moves, and trims all push a snapshot to WannaCut’s 100-step undo history. Press Ctrl+Z to undo and Ctrl+Y (or Ctrl+Shift+Z) to redo.

Build docs developers (and LLMs) love

Get started for freeTalk to us