Redcast Settings
Every Settings pane, what's in it, and the defaults.
Open Settings with ⌘, 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, Learned ranking and Hotkeys.
Permissions
Shows feature permission status, including Accessibility, Calendars and Microphone, and opens the relevant System Settings pane. See Permissions.
Launcher
| Pane | What's in it |
|---|---|
| Applications | 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 |
| Quicklinks | Quicklinks switch, its commands, behavior, import and export |
| Fallbacks | Which fallbacks show under a search, and their order |
Most rows have a launcher checkbox, a shortcut recorder and an alias 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 | 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, AI commands |
| Quick Actions | Enable Quick Actions | Actions (Replace or Preview, shortcut, prompt, model), Add Quick Action, Model, Translate to |
| File Search | Enable File Search | Show in launcher (Off), Commands, Search Scopes, Ignore Patterns |
| Notes | Enable Notes | Notes commands |
| Snippets | Enable snippets | Show in launcher, snippet commands, New Snippet, Snippets Folder |
| Navigation | Enable navigation | Commands, Show Apple menu items (Off), Disabled Applications |
| Window Management | Enable window management | Show in launcher, Cycling (None), Gap between windows (0), window commands, Window Layouts, Rooms |
| 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 | (always on) | Emoji commands, Emoji Skin Tone (Default) |
| 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 | Enable extensions | Show in launcher, Compatibility, installed extensions, Install, Registries, Package manager, Storage |
Advanced
Backup. Export a backup, import one, or import from Raycast. See Backup & restore.
About. Version, license, the Redcast project link and upstream attribution. Redcast uses the source-build update workflow.
Redcast additions
| Section | Controls |
|---|---|
| Shortcuts | All bindings, aliases, keywords and conflicts |
| AI → Providers | API connections, installed providers and ChatGPT sign-in |
| 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 | Local models, cloud route, modes and History |
| 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.