# Settings

> Every Settings pane, what's in it, and the defaults.

Open Settings with <kbd>⌘</kbd><kbd>,</kbd> from the palette, the **Settings** command or the menu
bar icon. It's a regular, resizable window.

**The search field finds any setting by name**, and also by related words that aren't in its title:
`ocr` finds **Search text in images and PDFs**, and `caps lock` finds **Hyper Key**. Choosing a
result takes you straight to that setting.

There are 21 panes in four groups.

## General

### General

| Setting      | Default  |
| ------------ | -------- |
| App Launcher | **None** |

| Setting                           | Options                                                            | Default                           |
| --------------------------------- | ------------------------------------------------------------------ | --------------------------------- |
| Learned ranking                   | **Reset…** clears all learned ranking                              |                                   |
| Hyper Key                         | None · Caps Lock · Left or Right Control, Shift, Option or Command | **None**                          |
| Quick Press                       | Does Nothing · the original key · Trigger Escape                   | **Does Nothing**                  |
| Include Shift (⇧)                 | On · Off                                                           | **On**                            |
| Secure Input Compatibility        | On · Off (Caps Lock only)                                          | **Off**                           |
| Theme                             | System · Light · Dark                                              | **System**                        |
| Interface size                    | Default · Large · Larger                                           | **Default**                       |
| Background transparency           | Less to More, with Reset                                           | Middle                            |
| Compact mode                      | On · Off                                                           | Off                               |
| Show favorites in compact mode    | On · Off                                                           | **On**                            |
| Follow the cursor across displays | On · Off                                                           | **On**                            |
| Drag to reposition                | On · Off                                                           | Off                               |
| Launch at login                   | On · Off                                                           | Off                               |
| Show in menu bar                  | On · Off                                                           | **On**                            |
| Pop to Root Search                | Immediately · After 5, 15, 30, 60 or 90 seconds                    | **Immediately**                   |
| Escape Key Behavior               | Navigate back or close window · Close window and pop to root       | **Navigate back or close window** |
| Auto-switch input source          | None, or any keyboard input source you have                        | **None**                          |

See [The palette](/docs/palette), [Learned ranking](/docs/launcher#learned-ranking) and
[Hotkeys](/docs/reference/hotkeys#hyper-key).

### Permissions

Shows feature permission status, including Accessibility, Calendars and Microphone, and opens the relevant System Settings pane. See [Permissions](/docs/permissions).

## Launcher

| Pane            | What's in it                                                                                                    |
| --------------- | --------------------------------------------------------------------------------------------------------------- |
| Applications    | [Search Scopes](/docs/launcher#search-scopes), **Enable Applications**, and a row per app                       |
| System Settings | **Enable System Settings**, and a row per pane                                                                  |
| System Actions  | **Enable System Actions**, and a row per action                                                                 |
| Commands        | **Enable Commands**, a row per built-in command, and [Custom Commands](/docs/launcher/commands#custom-commands) |
| Quicklinks      | [Quicklinks](/docs/launcher/quicklinks) switch, its commands, behavior, import and export                       |
| Fallbacks       | Which [fallbacks](/docs/launcher/fallbacks) show under a search, and their order                                |

Most rows have a launcher checkbox, a shortcut recorder and an [alias](/docs/launcher/aliases)
field. Long lists have a filter field.

The **Enable …** switch at the top of a pane turns off every row **and** every shortcut in it. A
row's checkbox only hides that row from search.

## Features

Everything here is **off** by default, except Clipboard and Emoji & Symbols.

| Pane                                                  | Switch                            | Other settings                                                                                                                                                                                                                                   |
| ----------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [AI](/docs/ai)                                        | Enable AI                         | Providers, Default model, Reasoning effort, Web search, Tool call rounds, Opens to, Start a new conversation after, Keep conversations, System prompt, [MCP servers](/docs/ai/mcp), AI commands                                                  |
| [Quick Actions](/docs/ai/quick-actions)               | Enable Quick Actions              | Actions (Replace or Preview, shortcut, prompt, model), Add Quick Action, Model, Translate to                                                                                                                                                     |
| [File Search](/docs/features/file-search)             | Enable File Search                | Show in launcher (**Off**), Commands, Search Scopes, Ignore Patterns                                                                                                                                                                             |
| [Notes](/docs/features/notes)                         | Enable Notes                      | Notes commands                                                                                                                                                                                                                                   |
| [Snippets](/docs/features/snippets)                   | Enable snippets                   | Show in launcher, snippet commands, New Snippet, Snippets Folder                                                                                                                                                                                 |
| [Navigation](/docs/features/navigation)               | Enable navigation                 | Commands, Show Apple menu items (**Off**), Disabled Applications                                                                                                                                                                                 |
| [Window Management](/docs/features/window-management) | Enable window management          | Show in launcher, Cycling (**None**), Gap between windows (**0**), window commands, [Window Layouts](/docs/features/window-layouts), [Rooms](/docs/features/rooms)                                                                               |
| [Clipboard](/docs/features/clipboard)                 | Enable Clipboard History (**On**) | Clipboard commands, Keep history for (**3 Months**), Search text in images and PDFs (**Off**), Default action (**Paste**), Disabled Applications, Clear history                                                                                  |
| [Emoji & Symbols](/docs/features/emoji)               | _(always on)_                     | Emoji commands, Emoji Skin Tone (**Default**)                                                                                                                                                                                                    |
| [Calendar](/docs/features/calendar)                   | Join meetings from Redcast       | Show in launcher, Upcoming meetings in launcher (**5 next**), Days to Show (**Today and Tomorrow**), Show the join card (**5 minutes**), Auto Join Meetings (**Off**), Camera Preview (**Off**), menu bar settings, Calendar commands, Calendars |
| [Extensions](/docs/extensions)                        | Enable extensions                 | Show in launcher, Compatibility, installed extensions, Install, Registries, Package manager, Storage                                                                                                                                             |

## Advanced

**Backup.** Export a backup, import one, or
[import from Raycast](/docs/reference/import-from-raycast). See [Backup & restore](/docs/reference/backup).

**About.** Version, license, the Redcast project link and upstream attribution. Redcast uses the source-build [update workflow](/docs/reference/updates).

## Redcast additions

| Section | Controls |
| --- | --- |
| [Shortcuts](/docs/reference/shortcuts-overview) | All bindings, aliases, keywords and conflicts |
| AI → Providers | API connections, installed providers and [ChatGPT sign-in](/docs/ai/chatgpt) |
| AI → Agents | Profiles, tool families, skills, permissions, defaults and schedules |
| AI → Screen Awareness | Capture destination and optional screenshots |
| AI → Agent Sessions | Local history sources, terminal and optional live status |
| AI → Usage | Reported tokens, costs and account snapshots |
| [Dictation](/docs/voice) | Local models, cloud route, modes and History |
| [Backup](/docs/reference/backup) | Full configuration, optional chats and encrypted supported secrets |

## Settings file

The opt-in mirror lives at `~/.config/redcast/settings.json` for the installed Redcast identity. Enable **Settings → Backup → Settings File**. The app remains the source of current settings and synchronizes supported keys with this file.

Only keys covered by the settings schema belong here. Credentials and capability-granting switches are not a way to bypass the normal consent flow. For the exhaustive schema and validation rules, see the [engineering reference](https://github.com/alesha-pro/redcast/blob/main/docs/features/settings-file.md).