> 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/troubleshooting.md).

# Troubleshooting

If you clicked **Troubleshooting** on an error in FireCut, look for the error's title below.

## Setup issues and how to fix them

<details>

<summary>I installed FireCut but I don't know how to open it</summary>

First, let's make sure you have completed the installation:

* **Mac:** You opened the .dmg file and copied FireCut from the .dmg to your Applications folder
* **Win:** You ran the .exe installer and it successfully finished installing FireCut

### Main way of opening FireCut

The main way to open FireCut is to run the app directly:

* **Mac:** Open your Applications folder and open "FireCut for DaVinci Resolve"
* **Win:** When you run the installer, it will automatically open FireCut for you. If you want to open it later, you have 3 options:
  * Open "FireCut for DaVinci Resolve" from your Desktop or the Start menu (these shortcuts were made during installation)
  * Open this file: `C:\Users\<your username>\AppData\Local\Programs\FireCut-DaVinci\FireCut for DaVinci Resolve.exe`
  * Just run the installer again
* **Linux:** Open FireCut from your applications menu, or run `firecut-davinci` in a terminal

This will open the FireCut window.

### If that didn't work: alternative method of opening FireCut

You can also open FireCut from DaVinci Resolve: go to **Workspace > Scripts > FireCut** (on Mac and Windows, **Workspace > Workflow Integrations > FireCut** works too). This opens FireCut while **Launch FireCut when DaVinci Resolve starts** is on in FireCut's **Settings**, which it is by default.

<div align="left"><figure><img src="https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2FQ7Vam2bu1X1mJyBrPNN5%2FRunPyScript.png?alt=media&amp;token=387d212d-703d-42e9-b8f4-6a4e9777270b" alt="" width="533"><figcaption></figcaption></figure></div>

If you still don't have any luck in opening the FireCut window, please let us know in our Discord or by emailing <support@firecut.ai>

### **After FireCut opens**

First you'll see the EULA. After you accept it, you'll see the **Get Started** screen:

* Click **I already have an account - sign in** and sign in. FireCut finds your DaVinci Resolve license for you.
* Or click **Enter my license key from my FireCut dashboard**, paste your key from your dashboard (<https://firecut.ai/accounts/dashboard/>) and click **Verify**.

<div align="left"><figure><img src="https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2FzNPf5psuSK6osA0Ql0Lw%2Fimage.png?alt=media&amp;token=3fdb9dbd-7694-411e-b2c6-9619363648c1" alt="" width="375"><figcaption></figcaption></figure></div>

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

</details>

<details>

<summary>FireCut stuck at "Not connected to DaVinci Resolve"</summary>

<div align="left"><figure><img src="https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2F7LWdIzqs3V3jBmyOIy31%2Fimage.png?alt=media&amp;token=bf092f9d-b9d9-436b-a9d4-e2d2a77ac1f4" alt="" width="375"><figcaption></figcaption></figure></div>

### Why this can happen

* FireCut is open, but it isn't connected to DaVinci Resolve yet. FireCut can't see your project and timeline until it is.
* No project is open in Resolve.
* A FireCut script from an earlier session is stuck in Resolve.
* The connection option you picked needs a setting in Resolve or your computer first.

### How to fix it

* Open a project in DaVinci Resolve, and check that the right edition is selected at the top of the FireCut screen: **Resolve Free** or **Resolve Studio**.
* Then connect with one of the options on the screen. See [Connecting FireCut to DaVinci Resolve](https://learn.firecut.ai/overview-davinci-resolve/installing-firecut.md#connecting-firecut-to-davinci-resolve) for how each one works. On the free version of Resolve 21.1 or newer, use **Connect with console automation** or the console command. On Resolve Studio, and on Resolve 20 or 21.0, you can go to **Workspace > Scripts > FireCut**.
* If an option fails, FireCut shows why under it:
  * **"macOS blocked UI automation"** --> Allow FireCut in System Settings > Privacy & Security > Accessibility, and allow System Events under Automation, then try again.
  * **"Direct connection unavailable"** --> In Resolve's Preferences under General, set **External scripting using** to **Local**. Or use **Connect with UI automation**, or run Workspace > Scripts > FireCut yourself.
  * **"Resolve menu automation failed"** --> Open a Resolve project and run Workspace > Scripts > FireCut yourself.
  * **"No connection received"** --> Connect by hand: click **Copy console command**, open Workspace > Console in Resolve, make sure **Lua** is selected, paste the command and press Enter.
  * **"FireCut.lua was not found"** --> Restart FireCut so it can put its script back, then try again.
* Still stuck on Resolve Studio (or Resolve 20 or 21.0)? Click **Stop all running scripts**, then connect again. Stuck scripts can stop FireCut from working.
* On Linux, one-click connecting needs X11 (or XWayland) and `xdotool`. See [Linux](https://learn.firecut.ai/overview-davinci-resolve/installing-firecut.md#linux).
* You don't need to have the FireCut app open first: running FireCut from Resolve opens it, while **Launch FireCut when DaVinci Resolve starts** is on in FireCut's **Settings**.

If the connection drops while you're using a feature, a **DaVinci Resolve disconnected** bar appears at the bottom of FireCut. Click it to see the same connection options.

</details>

<details>

<summary>FireCut missing from Workspace > Scripts</summary>

<div align="left"><figure><img src="https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2FEVWd1zFn89wTyAepR5pN%2Fimage.png?alt=media&amp;token=a1a1b408-7165-4226-8f47-e6216f4c0f33" alt=""><figcaption></figcaption></figure></div>

On the free version of DaVinci Resolve 21.1 or newer, you don't need the Scripts menu: connect with **Connect with console automation** or the console command instead.

### Why this can happen

* FireCut is not properly installed
* You just need a restart of your computer
* You use the Mac App Store version of DaVinci Resolve, which keeps its scripts in a different folder

### How to fix it

* First, check if FireCut is installed by going to these folders to check if the file **FireCut.lua** exists:
  * Mac: `~/Library/Application Support/Blackmagic Design/DaVinci Resolve/Fusion/Scripts/Utility`
    * *You can go to this path by opening Finder, then pressing `Cmd + Shift + G` to open Go to Folder... (or find this command from the Go menu at the top), then copy/pasting the path and pressing Enter.*\
      ![](https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2Fz3BNwEFds1ic8F8q4vwA%2Fimage.png?alt=media\&token=919d11e0-a9f5-474c-aa1c-271c51381090)
  * Mac App Store version of Resolve: `~/Library/Containers/<Resolve's folder>/Data/Library/Application Support/Fusion/Scripts/Utility`, where Resolve's folder starts with `com.blackmagic-design.DaVinciResolve`
  * Win: `%AppData%\Blackmagic Design\DaVinci Resolve\Support\Fusion\Scripts\Utility`
    * *You can go here by opening File Explorer, then copy/pasting the path into the path bar*\ <img src="https://4122560492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWDn6n1C7MKZBHdDcmm6f%2Fuploads%2F4KmMIbzmeOlJ7VleR5rz%2Fimage.png?alt=media&amp;token=fb940b5a-5ae3-4948-826f-f4d93f78c743" alt="" data-size="original">
  * Linux: `~/.local/share/DaVinciResolve/Fusion/Scripts/Utility`
* If you cannot find **FireCut.lua** in any of these locations, then run the FireCut installer again and open FireCut for DaVinci Resolve. This app will copy the **FireCut.lua** file to the correct location on startup. Then check these paths again.
* If you still do not see FireCut in your Scripts after a restart, please get in touch with us in our FireCut for DaVinci Resolve Discord (link in your email) or by emailing <support@firecut.ai>

</details>

<details>

<summary>I updated FireCut to a new version and now it doesn't work ("Resolve script update required" or "DaVinci Resolve needs a restart")</summary>

If you updated FireCut while DaVinci Resolve was open, Resolve keeps running the old FireCut script until it restarts, and FireCut can't replace it. The same alert shows if Resolve stops responding to FireCut. Save your project, restart DaVinci Resolve, then connect FireCut again (for example with Workspace > Scripts > FireCut, or the console command on the free version of Resolve 21.1 or newer).

We release updates often, so occasionally a feature may work differently than it did, or stop working. If the new version still doesn't work for you after a restart, you can go back to an earlier one from <https://firecut.ai/downloads/davinci-resolve/old/>, which lists the last few releases. Please also tell us what went wrong, so we can fix it.

</details>

<details>

<summary>"Unsupported DaVinci Resolve Version"</summary>

FireCut needs DaVinci Resolve 20 or newer. Click **Update DaVinci Resolve**, or get the latest version from Blackmagic Design. You don't need to reinstall FireCut.

</details>

<details>

<summary>"License Registered to Another Device"</summary>

A license key works on one computer at a time. If you've moved to a new computer:

1. Click **Unlink Old Device** to open your dashboard, and unlink your old computer there.
2. Go back to FireCut and verify your key again.

Each editor needs their own license key. The alert's **Need multiple licenses? See Team plans** link shows the options.

</details>

<details>

<summary>"Invalid License Key" or "License Not Active"</summary>

* **Invalid License Key** --> FireCut didn't accept the key. Check that:
  * You copied the whole key from your dashboard (click **Find my license key**).
  * It's a key for DaVinci Resolve. Keys are made for one app, so a key for FireCut for Premiere Pro may not work here. You can get a DaVinci Resolve plan on the [pricing page](https://firecut.ai/pricing/davinci-resolve/).
  * This computer hasn't already used a free trial. If it has, follow the instructions we emailed you, or add a payment card in your dashboard.
* **License Not Active** --> Your plan has ended. Choose a plan with **View Plans**, or check your account with **Manage account**.

You can paste a different key straight into the box in the alert.

</details>

<details>

<summary>"No Network Connection"</summary>

FireCut needs the internet for transcription and its AI features. Check your connection and try again.

If your internet works but FireCut still can't connect, you may be on a company network, VPN or proxy that inspects secure connections. In FireCut's **Settings**, under **Troubleshooting**, turn on **Disable certificate validation**. Only do this on that kind of network. The same option shows on the **Get Started** screen if FireCut can't reach us while you sign in.

</details>

<details>

<summary>"Out Of Transcription Usage"</summary>

You've used your plan's transcription allowance for this period. You can see your limits in **Settings** under **Quotas**. Your allowance comes back when it resets, or you can see the other plans on the [pricing page](https://firecut.ai/pricing/davinci-resolve/).

**Tip:** if your timeline already has a subtitle track, pick it as the transcript source (**Transcript source tracks** > **Subtitle track**) on features that use a transcript. This doesn't use your transcription allowance. On DaVinci Resolve Studio you can make a subtitle track with Timeline > AI Tools > Create subtitles from Audio.

</details>

<details>

<summary>"FireCut cannot read the timeline exported by Resolve"</summary>

This happens when your computer blocks FireCut from reading the files Resolve exported. On a Mac, it's most common with the Mac App Store version of DaVinci Resolve.

* **Mac:** In System Settings > Privacy & Security, allow FireCut access, then restart FireCut and try again. If it still fails, install DaVinci Resolve from Blackmagic Design's website instead of the Mac App Store.
* **Windows and Linux:** Check that your security software isn't blocking FireCut from the folder Resolve exports to, then try again.

</details>

## Other issues

If you face any other issues with setup that are not listed here, please message us in our FireCut for DaVinci Resolve Discord (link in your email) or email <support@firecut.ai>
