> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> What CoClip's error messages mean and how to fix them.

Find the message or symptom you see, then follow the fix. Messages are quoted in short; the one in the app may say a little more.

## Install and start

> [accordion] Windows or macOS blocks CoClip from installing or opening
>
> Windows SmartScreen and macOS can stop an app downloaded from the internet. The safe way through is on [Install CoClip](/docs/get-started/install.md).

## Export

> [accordion] "The disk is full."
>
> **Cause:** the drive you export to ran out of space while CoClip wrote the video.
>
> **Fix:** free some space on that drive, or export to another drive. Then export again.

> [accordion] "A file is locked by another program"
>
> **Cause:** another program has the output file or a media file open, such as a video player or a cloud sync tool.
>
> **Fix:** close the player, or pause the sync tool, then export again. Exporting under a new file name also works.

> [accordion] "A font used by the project could not be loaded."
>
> **Cause:** a font file in the project is missing or damaged.
>
> **Fix:** open the fonts list in the Library. A missing font is marked **missing** and has a **Relink** button. Relink it, or pick another font for that text. Then export again. See [Text, styles and fonts](/docs/library/text-styles-fonts.md).

> [accordion] "A media file used by the project is missing or unreadable."
>
> **Cause:** a video, image or audio file was moved, deleted or damaged.
>
> **Fix:** relink the file in the Library, then export again. See [Import and manage media](/docs/editing/import-media.md).

> [accordion] "The NVIDIA hardware encoder failed."
>
> **Cause:** the NVIDIA encoder on your PC stopped during the export.
>
> **Fix:** open **Settings** → **Media & export** and set **Render with** to **Software (CPU, slower)**. Export again. When you're done, you can set it back to **Auto (GPU engine when possible)**.

> [accordion] "A frame took too long to render."
>
> **Cause:** a frame waited too long for media or a font to load.
>
> **Fix:** check the Library for missing media or fonts and relink them. Then export again.

> [accordion] "Element … could not be drawn"
>
> **Cause:** an element on the timeline failed while rendering. The message names the element and the reason.
>
> **Fix:** select that element and fix what the message says, or delete it. Then export again.

> [accordion] "Export cancelled."
>
> **Cause:** the export was stopped before it finished.
>
> **Fix:** start it again with **File** → **Export…** (`Ctrl+E` / `⌘E`).

> [accordion] "Export failed: …" with another reason
>
> **Cause:** something CoClip doesn't have a plain-words message for.
>
> **Fix:** export again once. If it fails again, contact support (see the end of this page) and include the full message.

> [accordion] Export is slow on a PC without an NVIDIA GPU
>
> **Cause:** without a GPU that can export, CoClip uses the software engine on the CPU. Expect about 2× the GPU export time at 1080p, more at 4K.
>
> **Fix:** this is normal. Keep **Render with** on **Auto (GPU engine when possible)** so CoClip uses the GPU whenever it can. On macOS, export runs on the Apple GPU. See [Settings](/docs/reference/settings.md).

## Preview and media

> [accordion] A media file is marked missing in the Library
>
> **Cause:** the file was moved, renamed or deleted outside CoClip.
>
> **Fix:** click **Relink** on the file and choose it again. See [Import and manage media](/docs/editing/import-media.md).

> [accordion] "A video could not be played"
>
> **Cause:** CoClip can't decode this video and has no preview copy of it. The clip stays empty in the preview.
>
> **Fix:** relink the clip to a working copy of the file, or convert the video to MP4 (H.264) and import it again.

> [accordion] "An animated image could not be played"
>
> **Cause:** CoClip can't decode an animated image. It shows a placeholder in the preview and the export.
>
> **Fix:** replace the file with a working copy, or convert it to another format and import it again.

> [accordion] Preview proxies fail or look wrong
>
> **Cause:** the NVIDIA encoder on your PC makes bad preview copies.
>
> **Fix:** open **Settings** → **Media & export** and turn on **Make preview proxies with the CPU only**. It applies to new proxies.

## Transcription

> [accordion] "The last download failed: no internet connection."
>
> **Cause:** CoClip couldn't download the speech model. It needs one download before the first transcript: about 574 MB for **Best quality**, or 264 MB for **Fast**.
>
> **Fix:** connect to the internet and click **Retry download**. After the download, transcription works offline.

> [accordion] "The last download was damaged (checksum mismatch) and was deleted."
>
> **Cause:** the downloaded model file didn't match, often because the connection dropped. CoClip deleted it.
>
> **Fix:** click **Retry download**. If it keeps failing, try another network.

## Projects and windows

> [accordion] "You have … projects open (limit …)"
>
> **Cause:** you reached the limit of open projects. Projects an agent opened count too; the message lists them.
>
> **Fix:** close one of the listed projects, or raise **Open projects at once** in **Settings** → **General** (up to 8).

## Connectors and downloads

> [accordion] A connector shows "Re-enter key"
>
> **Cause:** CoClip can't read the saved key. It was saved by another CoClip install or another Windows account, or macOS Keychain access to "CoClip Safe Storage" was denied.
>
> **Fix:** on macOS, quit and reopen CoClip and choose **Always Allow** when macOS asks. Otherwise, paste the key again in **Settings** → **Connectors** and click **Save**. See [Connectors and API keys](/docs/reference/connectors.md).

> [accordion] "The key was refused" or "Out of … credits"
>
> **Cause:** the service rejected the key (wrong, revoked or missing a permission), or your account with it has no credits left.
>
> **Fix:** check the key and your balance on the service's website, then save the key again and click **Test connection**.

> [accordion] "yt-dlp is not installed" or "The video downloader is missing"
>
> **Cause:** the tool CoClip uses to import videos from links isn't available.
>
> **Fix:** on macOS, run `brew install yt-dlp`, then restart CoClip. On Windows, reinstall CoClip. See [Install CoClip](/docs/get-started/install.md).

## AI agents

> [accordion] An agent won't start, is too old, or can't sign in
>
> Each agent page lists its install steps, minimum version, sign-in and error messages:
>
> * [Claude Code](/docs/ai-agents/claude-code.md)
> * [Codex](/docs/ai-agents/codex.md)
> * [OpenCode](/docs/ai-agents/opencode.md)
> * [Antigravity](/docs/ai-agents/antigravity.md)

> [accordion] An agent made an edit you don't want
>
> Undo it from the AI log. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md).

## Still stuck?

Email [support@coclip.app](mailto:support@coclip.app) and include:

* your CoClip version (shown next to the CoClip name on the Start screen; on macOS also in **CoClip** → **About CoClip**)
* Windows or macOS, and its version
* the steps that lead to the problem
* a screenshot of the message
* if support asks, the app log `logs/main.log` (see [Project folder](/docs/reference/project-folder.md))


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.