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

# Settings

> What each Settings tab controls: appearance, export, downloads, AI assistants and connectors.

Open Settings with the gear button (**Settings**) in the window header. The tabs on the left are **General**, **Media & export**, **Downloads**, **AI assistants** and **Connectors**. Changes save as soon as you make them; click **Close** when you're done.

Screenshot coming soon

Settings dialog
State: General tab open
Highlight: Tab list on the left

## General

| Setting | What it does |
| - | - |
| **Theme** | **System**, **Light** or **Dark**. **System** follows Windows or macOS. |
| **Accent color** | **Magenta**, **Violet**, **Blue** or **Cyan**. It colors buttons, selection and focus. AI items stay lime. |
| **Open projects at once** | How many projects can be open at the same time, from 1 to 8 (default 4). Each project opens in its own window. Projects opened by an agent count too. Lowering the number doesn't close windows that are already open. |

## Media & export

| Setting | What it does |
| - | - |
| **Make preview proxies with the CPU only** | Skips the NVIDIA encoder when CoClip makes preview proxies. Turn it on if proxies fail or look wrong on your PC. It applies to new proxies. |
| **Render with** | Which engine exports your video. See the options below. |
| **FFmpeg** | Shows **Bundled with CoClip**, or the FFmpeg you chose. **Use another FFmpeg…** picks your own copy; ffprobe must sit in the same folder. CoClip shows both files' checksums and asks before it uses them. **Use bundled FFmpeg** switches back. |

**Render with** options:

* **Auto (GPU engine when possible)**: the default. CoClip uses the GPU engine and falls back when it can't export.
* **GPU engine**: decodes, layers and encodes the video on the GPU.
* **Software (CPU, slower)**: Windows only. Expect about 2× the GPU export time at 1080p, more at 4K.

On Windows, **Auto** and **GPU engine** fall back to the software engine when your GPU can't export. On macOS, they fall back to the x264 encoder when the Apple hardware encoder can't export; software (CPU) export isn't available on macOS yet. If no engine can draw the export, it fails and tells you why. See [Export your video](/docs/editing/export.md).

## Downloads

### Video downloader

CoClip imports videos from links with yt-dlp. This section shows the version in use and where it comes from.

* **Windows:** **Update downloader** gets the latest yt-dlp. After an update, **Use bundled version** switches back to the copy that came with CoClip.
* **macOS:** yt-dlp comes from Homebrew. Update it with `brew upgrade yt-dlp`.

**Use browser login** lets the downloader use your browser's login for links that need one. It's **Off** by default. You can choose Firefox, Chrome, Edge, Brave, Chromium, Opera or Vivaldi, and Safari on macOS.

* On Windows, Chrome and Edge may not work.
* Safari needs Full Disk Access for CoClip.
* The downloader reads the cookies only for imports that need a login. CoClip never stores them or shares them with an agent.
* An agent's imports use this setting only while CoClip is open.

### Map imagery

Satellite maps are cut from NASA's Blue Marble imagery. CoClip downloads it once and keeps it for every project. This section shows the cache folder and its size.

* **Retry** prepares imagery the open project is still missing.
* **Clear map imagery cache** frees the space. Each project keeps its own copy of the tiles it uses, so clearing the cache never breaks a project. You can't clear it while imagery is being prepared.

See [Maps](/docs/library/elements/maps.md).

## AI assistants

Choose how each agent starts in the AI dock. There is one choice each for **Claude**, **Codex** and **OpenCode**. It applies to the next session of that agent.

| Option | What the agent loads |
| - | - |
| **CoClip setup only (recommended)** | Only the CoClip tools, skills and agents. Your sign-in and model stay the same. Your own skills, plugins, MCP servers and settings stay out of video projects. |
| **Use my own … setup** | Your own configuration too, with the CoClip tools added for that session. |

Setting up and signing in to each agent is covered on its page: [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).

## Connectors

Add your own keys for ElevenLabs, OpenRouter, Vbee, Epidemic Sound and Freesound. See [Connectors and API keys](/docs/reference/connectors.md).

## Related pages

* [Keyboard shortcuts](/docs/reference/keyboard-shortcuts.md)
* [Project folder](/docs/reference/project-folder.md)
* [Troubleshooting](/docs/reference/troubleshooting.md)


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