Skip to main content
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

Windows SmartScreen and macOS can stop an app downloaded from the internet. The safe way through is on Install CoClip.

Export

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.
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.
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.
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.
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).
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.
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.
Cause: the export was stopped before it finished.Fix: start it again with File → Export… (Ctrl+E / ⌘E).
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.
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.

Preview and media

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.
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.
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.
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

Cause: CoClip couldn’t download the speech model. It needs one download before the first transcript: about MB for Best quality, or MB for Fast.Fix: connect to the internet and click Retry download. After the download, transcription works offline.
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

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

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.
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.
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.

AI agents

Each agent page lists its install steps, minimum version, sign-in and error messages:
Undo it from the AI log. See AI log and undo.

Still stuck?

Email 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)