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.

Text clips in WannaCut behave like any other clip on the timeline — they live on a dedicated Text track, support all keyframable properties (position, zoom, opacity, 3D rotation), and can be trimmed, split, and layered just like video clips. You choose a font from the sidebar, drag it onto the timeline, and type your content in the Properties panel. WannaCut renders the text in real time in the Three.js preview using the font you selected, so what you see during playback is exactly what gets exported.

Creating a Text Clip

1

Open the Text tab

Click the Text (T) icon in the left sidebar navigation. The panel switches to the font browser, loading your locally installed fonts immediately and fetching cloud fonts from the WannaCut server in the background.
2

Browse available fonts

The font browser shows two sections:
  • Local fonts (already installed in your settings folder’s fonts/ subfolder) — displayed with the font rendered in its own typeface so you can preview the style at a glance.
  • Cloud fonts (available to download) — shown with a dashed border and a Download button. Free fonts are available to all users; premium fonts are marked with a ◆ badge.
3

Drag a font onto the timeline

Click and drag any font card from the panel directly onto the timeline. Drop it on an existing Text track or onto an empty area to auto-create a new Text track at that position.
4

The text clip appears on its track

A new clip is created with a default duration and placeholder text. Select it to edit its content and styling in the Properties panel on the right.

Font Sources

WannaCut resolves fonts from two sources automatically.

Cloud Fonts

When the Text tab opens, WannaCut invokes the fetch_cloud_fonts Tauri command, which fetches the font catalogue from https://wannacut.app/assets/fonts/. Each font entry is previewed in its own typeface directly in the browser using a dynamically injected @font-face rule — no download required to preview. Cloud fonts that are not yet installed appear with a dashed border. Only free-tier fonts have the Download button active; premium fonts require a subscription.

Local Fonts

Fonts stored in <settingsFolder>/fonts/ (the settings folder is configured in Settings → Workspace and stored as wannacut_settings_folder in localStorage) are scanned at startup and whenever you click Reload Fonts. Any .ttf, .otf, or compatible font file placed in that folder will appear in the local section of the Text tab immediately after reloading.

Downloading a Cloud Font

1

Find the font in the Text tab

Scroll the font browser to locate the cloud font you want. It has a dashed border and a ↓ Download icon.
2

Click the Download button

WannaCut calls the download_font_file Tauri command, which fetches the file from https://wannacut.app/assets/fonts/<name>.ttf and saves it to <settingsFolder>/fonts/<name>.ttf (where settingsFolder is stored in localStorage as wannacut_settings_folder). A progress bar appears at the bottom of the font card during the download.
3

Font is installed and ready

Once the download completes (progress bar reaches 100%), WannaCut calls loadSystemFonts to rescan the fonts folder. The font moves from the cloud section to the local section and becomes draggable onto the timeline.
Fonts are loaded from the fonts/ subfolder inside your settings folder (<settingsFolder>/fonts/) at startup. If you manually copy a font file into that folder while WannaCut is already running, click Reload Fonts in the Text tab toolbar to make it available without restarting.

Text Clip Properties

Select a text clip and open the Properties panel on the right side to configure it:

Text Content

The string displayed on screen. Type directly in the text field. Supports multi-line text — press Enter for a new line.

Font

Drop-down of all fonts currently loaded (local + newly downloaded). Changing this field hot-swaps the typeface in the preview immediately.

Font Size

Size in pixels as rendered on the canvas. The default canvas resolution is set in Project Settings; text size scales proportionally if you change resolution.

Font Color

Hex color picker, default #ffffff (white). Click the swatch to open the color picker and choose any solid color for the text fill.

Background Color

Optional solid background rectangle behind the text, controlled by the font_bgcolor property. Leave empty for a transparent background.

Background Size

Sets the width and height of the background rectangle via bg_dimetions (an X/Y position object). Use this to create a custom-sized caption bar or subtitle box.

Font Shine

Adds a glow or shine effect to the text. The font_shine object exposes three sub-properties: size (spread radius), intensity (strength of the glow), and color (hex color of the glow, independent of the text fill color).

Animating Text

Text clips are fully keyframable. You can animate Position, Zoom, Opacity, and 3D Rotation over time using the same keyframe workflow as video clips — right-click the clip → Keyframable → choose a property to open its curve track. For a complete walkthrough of placing, editing, and deleting keyframes, see the Keyframes guide.

Build docs developers (and LLMs) love