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.

The System tab in the WannaCut Settings modal (labeled WannaCut internally) is where you configure everything that applies globally across all projects: the workspace root folder, the settings folder, GPU hardware selection, and font management. These settings persist on disk and survive application restarts — they are independent of any individual project file.

​
Workspace Folder

The workspace folder is the root directory WannaCut uses to store all your projects. You are prompted to set it on first launch; without it, you cannot create or open projects. WannaCut stores this path in two places to ensure it survives a browser-storage reset:
  1. localStorage key: wannacut_settings_folder — used for fast startup reads inside the Tauri WebView.
  2. wannacut_settings.json — a JSON file written inside the settings folder itself. WannaCut re-reads this file if localStorage is cleared.
The wannacut_settings.json file has the following shape: 
{
  "workspace": "/home/user/WannaCut/project_wannacut",
  "gpu": null,
  "shortcuts": ""
}
KeyTypeDescription
workspacestringAbsolute path to the projects root directory
gpustring | nullName of the selected GPU device. null means auto-select
shortcutsstringReserved for future custom shortcut bindings

​
Directory Structure

WannaCut uses two separate top-level directories that serve different purposes:
  • Settings folder (wannacut_settings_folder) — stores application-level data: wannacut_settings.json, the fonts/ directory, and other global app files. This path is stored in localStorage and displayed as Settings Folder in Settings → System.
  • Workspace root (workspace key in wannacut_settings.json) — stores your projects. Each project lives in its own subdirectory here.
WannaCut creates and manages both structures automatically. 
<settings_folder>/
├── wannacut_settings.json       ← global app settings
├── fonts/
│   ├── MyFont.ttf
│   └── AnotherFont.otf
└── (other WannaCut app data)

<workspace>/
└── <ProjectName>/
    ├── videos/                  ← imported asset files (copied on import)
    ├── extracted_audios/        ← auto-extracted audio tracks from video clips
    ├── thumbnails/              ← generated thumbnail cache (FFmpeg)
    ├── main<timestamp>.project  ← auto-save snapshots (JSON, one per save)
    └── project.json             ← project config (name, resolution, FPS)
  • videos/ — when you import a media file, WannaCut copies it into this directory so the project remains self-contained regardless of where the original file lives.
  • extracted_audios/ — WannaCut uses FFmpeg to extract the audio track from every imported video clip and stores the resulting .mp3 here. This is used for waveform display and audio-only operations.
  • thumbnails/ — cached frame thumbnails generated at import time. Deleting this folder forces WannaCut to regenerate thumbnails on next open (slower first load, no data loss).
  • main<timestamp>.project — each save writes a new timestamped snapshot file. These are the versioned backups you can browse and restore from the History tab in Settings.
  • project.json — stores the current project configuration (name, width, height, FPS, background color, sample rate). Updated every time you click Apply Changes in Project Settings.

​
Fonts Directory

WannaCut scans the <settings_folder>/fonts/ directory at startup and whenever you click Reload Fonts in the Text panel. Any .ttf or .otf file placed in this directory becomes immediately available in the Text tab font picker.
The fonts/ directory lives inside the settings folder (shown in Settings → System as Settings Folder), not inside the workspace root. These are two separate directories: the workspace holds your project files, while the settings folder holds application-level data such as fonts and wannacut_settings.json.
1

Locate your settings fonts folder

Open Settings → System and note the Settings Folder path. Navigate to that directory and open (or create) the fonts/ subdirectory.
2

Copy font files

Place your .ttf or .otf font files directly into <settings_folder>/fonts/. Nested subdirectories are not scanned — keep all fonts at the top level of the fonts/ folder.
3

Reload fonts in WannaCut

Switch to the Text tab in the left panel and click Reload Fonts. Your new fonts will appear in the font dropdown immediately.
Cloud fonts downloaded directly through the Text tab’s built-in browser are also saved to this fonts/ directory automatically, so they persist across restarts.

​
GPU Configuration

WannaCut uses WebGL (via Three.js) for real-time canvas rendering and relies on your GPU for hardware-accelerated preview playback. The GPU selector in Settings → System lets you choose which graphics device to use. On launch, WannaCut calls a Tauri backend command (get_system_gpus) to enumerate all available GPU adapters on your machine. Select one from the dropdown, or leave it on None to let the system auto-select. The chosen GPU is passed to the Three.js WebGLRenderer with powerPreference: "high-performance", which instructs the browser runtime to prefer the selected discrete adapter over integrated graphics.
Without a GPU selected (or when GPU acceleration is unavailable), advanced AI-powered features such as Background Removal and Vocal Extraction will be disabled or will run significantly slower on the CPU. For the best experience, always configure a dedicated GPU if your machine has one.

​
Important Warnings

Do not move or rename the workspace folder while WannaCut is running. The application holds open file handles and path references to files inside the workspace. Moving the folder mid-session will cause import failures, save errors, and broken asset references. Always close WannaCut first, then update the Workspace Root path in Settings → System before re-opening the application.
wannacut_settings.json is the authoritative source of truth for global settings. If the localStorage entry for wannacut_settings_folder is ever cleared (for example, after a system update or browser data wipe inside the Tauri WebView), WannaCut will prompt you to point it to the existing settings folder again. Once you do, it reads wannacut_settings.json and restores all your previous configuration — no data is lost.

Build docs developers (and LLMs) love

Get started for freeTalk to us