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 is available as a free download from the official website at wannacut.app. Pre-built installers are provided for Linux (.deb package for Debian/Ubuntu-based distributions) and Windows (.exe installer). Because WannaCut bundles its own FFmpeg binary, there is no need to install any media framework separately — download, install, and you are editing within minutes.

​
System Requirements

Linux

OS: Ubuntu 22.04+, Debian 12+, or any distribution with GTK 3 and WebKit2GTK 4.1CPU: Modern 64-bit processor (x86_64)RAM: 4 GB minimum — 8 GB recommended for multi-track projectsGPU: Any GPU with OpenGL 3.3+ support; a dedicated GPU (NVIDIA / AMD) is recommended for hardware-accelerated effects and background removalDisk: 500 MB for the application; additional space for your workspace and media filesDisplay: 1280 × 720 minimum (1920 × 1080 recommended)

Windows

OS: Windows 10 (64-bit, version 1903 or later) or Windows 11CPU: Modern 64-bit processor (x86_64)RAM: 4 GB minimum — 8 GB recommended for multi-track projectsGPU: Any GPU with DirectX 11 / OpenGL 3.3+ support; a dedicated GPU (NVIDIA / AMD) is recommended for hardware-accelerated effectsDisk: 500 MB for the application; additional space for your workspace and media filesDisplay: 1280 × 720 minimum (1920 × 1080 recommended)

​
Linux Installation

1

Download the Linux installer

Visit wannacut.app and click the Download for Linux button. You will receive a .deb package suitable for Debian, Ubuntu, Linux Mint, and compatible derivatives.
2

Install the package

Open a terminal in the directory where the file was downloaded and run:
sudo dpkg -i wannacut_*.deb
sudo apt-get install -f   # resolves any missing system dependencies
The installer registers WannaCut in your application menu automatically. If you prefer a portable option, check the website for an AppImage release — simply mark it executable and double-click.
chmod +x WannaCut-*.AppImage
./WannaCut-*.AppImage
3

Launch WannaCut

Search for WannaCut in your application launcher, or run it from a terminal:
wannacut
On first launch you will be prompted to configure your workspace folder (see First Launch: Workspace Setup below).

​
Windows Installation

1

Download the Windows installer

Visit wannacut.app and click the Download for Windows button. You will receive a standard .exe installer.
2

Run the installer

Double-click the downloaded .exe file. If Windows SmartScreen shows a warning, click More info → Run anyway — WannaCut is open-source software and safe to run.Follow the installer wizard to choose an installation directory and create a Start Menu shortcut.
3

Launch WannaCut

Open WannaCut from the Start Menu or from the desktop shortcut that was created during installation. On first launch you will be prompted to configure your workspace folder.

​
First Launch: Workspace Setup

When WannaCut opens for the first time — or whenever it cannot find a previously configured workspace — it displays the Settings modal opened on the System tab. You must complete two folder selections before you can create or open projects:
  1. Settings Folder — WannaCut creates a wannacut_settings subdirectory at the path you choose and stores your global preferences (GPU selection, keyboard shortcuts) in a file named wannacut_settings.json. The path to this folder is persisted in localStorage under the key wannacut_settings_folder.
  2. Workspace Root — This is the parent directory where all of your projects will live. WannaCut creates a project_wannacut subdirectory here and records the path inside wannacut_settings.json.
You must set both the Settings Folder and the Workspace Root before creating a project. Trying to create a project without a workspace will result in an error. You can change either path at any time from Settings → System without losing your existing projects — WannaCut will offer to migrate your data to the new location.
After saving your settings, the Project Manager will load and you can click New Project to get started.

​
Bundled Dependencies

WannaCut ships with a bundled FFmpeg binary (bin/ffmpeg) that is used for all media decoding, audio extraction, thumbnail generation, and video export. You do not need to install FFmpeg separately. On Linux the .deb package also lists libwebkit2gtk-4.1-0, libgtk-3-0, libdc1394-25, libarmadillo12, and GStreamer plugins as system-level dependencies — these are resolved automatically by apt during installation.

​
Getting Help

Stuck on installation or running into a bug? The WannaCut community is active on Reddit. Join r/WannaCut to ask questions, share projects, and follow development updates. You can also find video tutorials on the official YouTube channel.

Build docs developers (and LLMs) love

Get started for freeTalk to us