> For the complete documentation index, see [llms.txt](https://learn.firecut.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.firecut.ai/overview-davinci-resolve/installing-firecut.md).

# Installing FireCut

{% hint style="info" %}
FireCut needs DaVinci Resolve 20 or newer. It works with both the free version of DaVinci Resolve and DaVinci Resolve Studio. A few options need Resolve Studio or Resolve 21.1 or newer, and the feature pages point these out.
{% endhint %}

## What you need

* **Mac:** macOS 13 (Ventura) or newer, on Apple Silicon or Intel.
* **Windows:** 64-bit Windows 10 or 11.
* **Linux:** a 64-bit Debian-based distribution (see [Linux](#linux) below).
* **A license key for FireCut for DaVinci Resolve.** Keys are made for one app, so check on your [dashboard](https://firecut.ai/accounts/dashboard/) that yours is for DaVinci Resolve.
* **An internet connection** while you use FireCut.

## Windows and Mac

1. **Download FireCut** for your computer from your [dashboard](https://firecut.ai/accounts/dashboard/) or the [downloads page](https://firecut.ai/downloads/davinci-resolve/). On a Mac, pick **Apple Silicon** for M1, M2, M3 and newer Macs, or **Intel Mac** for older ones.
2. **Close DaVinci Resolve**, then install FireCut:
   * **Mac:** open the .dmg file and drag FireCut into your Applications folder.
   * **Windows:** run the .exe installer. It installs FireCut, adds a Desktop shortcut and opens FireCut for you. If Microsoft Defender or your browser blocks the download, update Defender or try a different browser.
3. **Open FireCut** and accept the EULA. On the **Get Started** screen, either click **I already have an account - sign in** (FireCut finds your DaVinci Resolve license for you), or click **Enter my license key from my FireCut dashboard**, paste your key and click **Verify**.
4. **Open DaVinci Resolve and open a project**, then connect FireCut to it (see below).

## Getting a license key

Your license key is in your [dashboard](https://firecut.ai/accounts/dashboard/). If you don't have one yet, choose a plan on the [DaVinci Resolve pricing page](https://firecut.ai/pricing/davinci-resolve/), where you can also start a free trial. Keys are made for one app, so make sure you pick a plan for DaVinci Resolve. Once you've checked out, your license key is in your dashboard.

To change your key later, go to FireCut's **Settings** > **License key**.

## Connecting FireCut to DaVinci Resolve

FireCut is a separate app that works with the project you have open in DaVinci Resolve. When it isn't connected, FireCut shows **Not connected to DaVinci Resolve** with the ways to connect. Open a project in Resolve first.

At the top, choose **Resolve Free** or **Resolve Studio**. FireCut usually detects your edition and shows your Resolve version at the bottom. If it can't tell, pick it yourself.

### Resolve Free (version 21.1 or newer)

1. Click **Connect with console automation**. Keep Resolve in front while it connects. FireCut opens Workspace > Console in Resolve, runs its command and closes the console once it's connected.
2. If that doesn't work, connect by hand: click **Copy console command**, open **Workspace > Console** in Resolve, make sure **Lua** is selected, paste the command and press Enter. Once FireCut connects, close the console and leave Resolve open.

On a Mac, macOS may ask you to allow FireCut to control your computer the first time. Allow it in System Settings > Privacy & Security > Accessibility.

### Resolve Studio, and Resolve 20 or 21.0

FireCut shows **Connect automatically** with 2 options:

* **Connect to Resolve script host:** first, in Resolve's Preferences under General, set **External scripting using** to **Local**.
* **Connect with UI automation:** FireCut runs Workspace > Scripts > FireCut in Resolve for you. On a Mac, allow FireCut in System Settings > Privacy & Security > Accessibility, and allow System Events under Automation, when macOS asks.

You can also run **Workspace > Scripts > FireCut** in Resolve yourself. Tick **Connect this way after FireCut starts** under an option to use it every time you open FireCut.

On **Resolve Studio 21.1 or newer**, there's also **Connect to AI Agent Integration**, which uses the AI Agent Integration that comes with Resolve Studio. For this one, set **External scripting** to **Local** and **Automatic scripted actions** to **Allow safe** in Resolve's General preferences.

### Opening FireCut from DaVinci Resolve

Once FireCut is installed, running **Workspace > Scripts > FireCut** in Resolve (or, on Mac and Windows, **Workspace > Workflow Integrations > FireCut**) also opens FireCut if it isn't running. This works while **Launch FireCut when DaVinci Resolve starts** is on in FireCut's **Settings**, which it is by default. On Linux, open FireCut yourself first.

## Settings worth checking

In FireCut's **Settings**:

* **Launch FireCut when DaVinci Resolve starts** (on by default) and **Close FireCut when closing DaVinci Resolve** (off by default).
* **Share timeline stills** (if it's available on your plan): FireCut's AI can look at still frames from your timeline to understand your footage better. Choose **Never**, **Ask for permission** or **Auto accept**. It's on **Auto accept** until you change it.
* **Store timeline backups in FireCut bin** (on by default): before FireCut changes a timeline, it keeps the previous version in the Media Pool's **FireCut** > **Undo** bin, up to **Max undo history (backups) in FireCut bin** (5 by default). The **Undo** button at the top of FireCut takes you back.
* **Disable certificate validation** (under **Troubleshooting**): only turn this on if FireCut can't connect because you're on a company network or proxy that inspects secure connections.

## Updating FireCut

When a new version is out, FireCut shows an **Update Available** bar with a **Download** button. This works the same on Mac, Windows and Linux. FireCut doesn't update itself.

To update, close DaVinci Resolve, install the new version over the old one, then open Resolve and connect again. If Resolve was open while you updated, restart it: Resolve keeps running the old FireCut script until you do.

## Linux

FireCut for DaVinci Resolve is available on Linux as a 64-bit Debian package (.deb). This package can be installed on any Debian-based distribution, such as Ubuntu, Pop!\_OS, or Linux Mint. Install it with your package manager, for example `sudo apt install ./firecut-davinci.<version>.amd64.deb`, so it also installs `ffmpeg`, which FireCut needs. Afterwards, you'll see the FireCut icon in your applications menu, or you can launch it via the terminal (`firecut-davinci`).

RPM-based distributions like Fedora can install the Debian package using the `alien` utility, which converts .deb packages to .rpm format. The documentation for `alien` can be found [here](https://wiki.debian.org/Alien).

Arch-based distributions, including Manjaro, can also install the Debian package using the `debtap` utility, which can be installed from the AUR (Arch User Repository). The documentation for `debtap` can be found [here](https://github.com/helixarch/debtap?tab=readme-ov-file#debtap).

A few things work differently on Linux:

* **Open FireCut yourself** before you connect it from Resolve.
* **Connect with console automation** and **Connect with UI automation** need Resolve running in an X11 session (or XWayland) and the `xdotool` package (`sudo apt install xdotool`). Wayland isn't supported. If you can't use them, connect by hand with the console command.
* **Workspace > Workflow Integrations** isn't available on Linux.

## Installation problems?

If you have any trouble installing or opening FireCut, try the suggestions in our [troubleshooting page](https://learn.firecut.ai/overview-davinci-resolve/troubleshooting.md).
