Settings

Open Settings with the gear icon in the header, the burger menu's Settings..., the File menu's Settings..., or Cmd+, on macOS. This page walks every section.

API keys

Tabbed by provider: Fal.ai, OpenRouter, Google, OpenAI, Anthropic, ElevenLabs. Paste a key and Save, or Clear it. Saved keys display masked with the last four characters and a storage note ("Stored securely" via your system credential store, or session only, clearing on quit). What each provider unlocks is covered in Connect providers.

Below the tabs, Use Fal for OpenRouter routes OpenRouter calls through your Fal key, so one account covers both.

External Apps

Rows for Photoshop, Blender, ZBrush, Maya, GIMP, and Krita, each with Browse... (point it at the app's executable) and Clear. Configured apps appear on the asset right-click's "Open With" menu, so "open this texture in Krita" becomes two clicks.

Backup

The "Copy target" path with Browse and Clear. This is where the File menu's Backup Copy To Directory places its timestamped project copies; zip backups ask for a location each time instead. Full flow in Backups.

Agents

Home of the built-in personas, each with its own provider dropdown (OpenRouter, Google (Gemini), OpenAI, Anthropic (Claude)). "Agent Creator" helps you write new Assistant presets. "Lyric Smith" writes song lyrics and can generate the finished song. See Assistant.

Tool Models

Controls which pipelines power the Assistant's tools. The "Image Edit" row has Cheap, Normal, and High pipeline selects, matching the quality tiers you can ask for in chat.

Software Update

The section opens with its own promise: "Nothing is ever downloaded or installed without your say-so." It offers Check Now, an auto-check checkbox (on by default), a check frequency (hourly, every 6 hours by default, every 12 hours, or daily), and a skipped-version display with Clear. Details and the Windows-only caveat in Updates.

Device

Your activation seat: Get License and Release this device. See Activation.

FFmpeg

Where your FFmpeg install is, and whether Kitlig can see it. Normally it finds one on its own and this reads Found FFmpeg with a version. If it doesn't, Install FFmpeg for me runs your package manager (winget on Windows, Homebrew on macOS) and re-checks when it finishes, Locate FFmpeg... lets you point at the program file, Use auto-detect hands the job back to Kitlig, and Re-check looks again after you've installed it by hand. Kitlig also flags here when a build is missing a codec. Full setup in Set up FFmpeg.

Local Inference

Run supported operations on your own hardware instead of the cloud.

Enable local inference turns the feature on.
Downloadable model cards: each is an ONNX model (a portable neural-network file) with Download (progress bar plus a license click-through), Delete, and a "Use for" select per task: Cloud (Fal), Local (this device), or Prefer local.
"Your Local Models" lists models you've registered yourself. Add Model... opens a dialog with a title, a Task select, and YOLO preprocessing and normalization options for models that need them. This is also where custom detection models for Object tracking get registered. Tasks: Remove Background (segmentation), Upscale (tiled super-resolution), JPEG Artifact Removal (1x restoration, tiled with reflect padding; tile size, overlap and Swin window size fields, see Canvas), Depth Map, Object Detection, Pose Estimation, Instance Segmentation.

Language coverage

The local voice and speech models don't all cover the same set of languages. Check the tables below before you plan a dub or a transcript around one.

Whisper Transcription (Local) transcribes close to a hundred languages with no list to check against; quality still favors English and the other major European languages, as with any Whisper build.

Chatterbox Multilingual Voice Clone synthesizes and clones voices in 23 languages:


Arabic	Finnish	Malay
Chinese	French	Norwegian
Danish	German	Polish
Dutch	Greek	Portuguese
English	Hebrew	Russian
	Hindi	Spanish
	Italian	Swahili
	Japanese	Swedish
	Korean	Turkish

Note

Three of these need a bit of prep on the text going in. Chinese needs Traditional script; Simplified characters aren't in the model's lookup table and fail to synthesize. Japanese needs kana only; feed it kanji and Kitlig stops with an error rather than guessing. Hebrew works fine without diacritics (the little vowel marks), but the model is guessing at vowel sounds when they're missing.

Local text translation is narrower still. OPUS-MT only covers six directions, all of them paired with English:

Source	Target
English	German
German	English
English	Spanish
Spanish	English
English	French
French	English

A source and target outside those six pairs has no local translation path. Route it through a cloud provider instead, or translate through English as a middle step if both legs are covered.

Inference engine

Local models run through a small helper program that ships with Kitlig, called the sidecar. It keeps the heavy math out of the app itself and runs models noticeably faster than the old built-in path. You don't have to set anything up: it starts on its own when a local job needs it and shuts down after a few idle minutes.

Use sidecar is on by default. Turn it off and local jobs run inside the app the old way. If the sidecar ever fails to start, Kitlig falls back to that path on its own, so a job never dies just because the helper did.
The status line shows what the engine is doing: idle, or running with a version and either "CPU build" or "CUDA build". When it runs on your graphics card it also shows the GPU name and how much video memory is in use.

CUDA support for NVIDIA cards

If you have an NVIDIA GPU, you can run some local models on it. CUDA is NVIDIA's system for doing that kind of math on the graphics card.

Click Download CUDA support (1.8 GB) in the Inference Engine card.
Wait for the progress bar to finish. Kitlig checks every file it downloaded before trusting it, then restarts the sidecar with the GPU libraries loaded.
The CUDA runtime field fills in with the install location, and the next local job uses the card.

The files land inside your model storage folder, so they follow the Storage location you've picked. Remove deletes them and returns to CPU. Browse... is for pointing at a CUDA runtime folder you've unpacked yourself; most people never need it.

Note

The GPU helps most with the convolutional models: stem splitting, upscaling, and diarization (working out who speaks when). Voice cloning is currently fastest on the sidecar's CPU engine, and Kitlig routes it there automatically, so don't be surprised when a voice job reports CPU on a machine with a good graphics card.

Per-model device choice

Once a model is downloaded, a GPU / CPU chip pair appears next to it. Kitlig ships a sensible default per model (Whisper favors GPU, Chatterbox favors CPU, from its own benchmarking), so you don't need to touch these unless you want to override one after testing your own hardware. GPU still falls back to CPU automatically if no CUDA runtime is loaded, so picking GPU is never a way to break a model that would otherwise run.

MCP Server

Lets outside tools (like an AI agent on your machine) control Kitlig through a local connection. Off unless you turn it on.

Enable MCP server starts it.
Port (default 8420) and the endpoint address http://127.0.0.1:<port> with a copy button.
Access Token: generate one and copy it immediately. The dialog warns you it's shown once and can't be viewed again; Regenerate replaces it if it's lost or leaked.

If none of that means anything to you, leave the section alone; nothing in normal artist use needs it.

Plugins

This section only appears when an enabled plugin declares settings of its own. Its contents come from the plugin. See Plugins.

Two customization dialogs live in the burger menu rather than Settings:

Theme...: pick a built-in theme, build your own in Custom (surfaces, accents, and text swatches), save it under a name, choose fonts and a background image, and share themes as kitlig-theme.json files. Covered in Themes.
Plugins...: covered in Plugins.

Settings also holds Replay onboarding tour if you want the first-launch walkthrough again.