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.

Every WannaCut project carries its own independent settings for canvas dimensions, frame rate, background color, and audio sample rate. You can reach the Project Settings modal at any time by clicking the Settings icon (⚙) in the editor header, or by opening the gear icon in the Project Manager before loading a project. Changes take effect immediately upon clicking Apply Changes.

Settings Modal Tabs

The Settings modal is organized into three sidebar tabs, each represented by a small icon on the left rail:
  • Project — per-project settings such as resolution, FPS, and audio sample rate. This tab is only available when a project is open.
  • System (WannaCut) — global application settings including workspace folder, GPU selection, and the settings folder path. Available at all times.
  • History — a log of auto-saved project snapshots you can restore. Covered in depth on the Project Manager concept page.

Project Settings Fields

name
string
required
The human-readable name for your project. This label appears in the Project Manager list and is also used as the default filename suggestion when exporting video. Rename it at any time without affecting saved files.
width
number
Canvas width in pixels. Determines the horizontal resolution of the preview renderer and the exported video. Defaults to 1920. You can type a custom value or select one of the built-in presets below.
height
number
Canvas height in pixels. Determines the vertical resolution of the preview renderer and the exported video. Defaults to 1080. Pair with width for the correct aspect ratio.
fps
number
Playback and export frame rate. WannaCut supports 23.976, 24, 30, and 60 fps. The default is 24. This value controls both the preview renderer tick rate and the FFmpeg export parameters.
backgroundColor
string
Hex color code for the canvas background, visible wherever no clip covers the frame. Defaults to #000000 (black). Any valid six-digit hex value is accepted (e.g. #1a1a2e).
sampleRate
number
Audio sample rate in Hz for the exported audio mix. WannaCut supports 44100 Hz and 48000 Hz. The default is 48000 Hz, which is the broadcast standard used by most cameras, streaming platforms, and DAWs.

Preset Resolutions

WannaCut ships with four one-click format presets that set both width and height simultaneously. Click a preset button in the Format Presets section to apply it, then fine-tune the values manually if needed.

1080p Full HD

1920 × 1080 — 16:9 landscape. The universal standard for YouTube, streaming, and broadcast. Best starting point for most projects.

TikTok / Shorts

1080 × 1920 — 9:16 portrait. Optimized for TikTok, Instagram Reels, and YouTube Shorts. Fills a phone screen edge to edge.

4K Ultra HD

3840 × 2160 — 16:9 at four times 1080p pixel density. Use for high-quality masters or when distributing on 4K-capable platforms. Requires more GPU memory during preview.

Instagram Square

1080 × 1080 — 1:1 square format. Ideal for Instagram feed posts, Facebook, and any context where equal width and height is required.
Changing the canvas resolution after you have already placed clips on the timeline is fully supported — the Three.js renderer and preview canvas resize automatically. However, clips that reference absolute pixel positions (such as text overlays or manually repositioned video clips) may appear off-center after a resolution switch. Review each clip’s position properties in the Properties panel after making the change.
Choose your target FPS before you begin a long edit session. The FPS value is baked into keyframe timing calculations — switching from 24 fps to 30 fps mid-project will cause all existing keyframes to play back at a different effective speed relative to the clock. Lock it in early to avoid having to re-time animated properties.

Build docs developers (and LLMs) love