Settings keys
Every setting Vela knows, as it appears in settings.json. Most also have a control in the Settings window (⌘,). Click a key to get a link to it.
Always current
This list is generated from Vela's source code each time the site is built, so it matches the latest release.
Appearance
| Setting | Description |
|---|---|
appearance.themeDefault "Palenight" | Theme used when appearance.followSystem is off.String |
appearance.preferredDarkThemeDefault "Palenight" | Theme used in Dark Mode when appearance.followSystem is on.String |
appearance.preferredLightThemeDefault "Lighter" | Theme used in Light Mode when appearance.followSystem is on.String |
appearance.followSystemDefault true | Switch between the preferred dark and light themes with the system appearance. Boolean |
appearance.colorCustomizationsDefault {} | Overrides for theme color tokens, e.g. {"chat.background": "#1e1e2e"}. Object |
Chat
| Setting | Description |
|---|---|
chat.layoutDefault "grouped" | Message layout: classic, grouped or columns. One of "classic", "grouped", "columns" |
chat.fontFamilyDefault "" | Chat font family. Empty uses the system font. String |
chat.fontSizeDefault 13 | Chat font size in points. Number |
chat.monospaceFontFamilyDefault "SF Mono" | Font for code spans and the columns layout's fixed-width parts. String |
chat.lineSpacingDefault 2 | Extra spacing between lines of a message, in points. Number |
chat.messageSpacingDefault 6 | Spacing between message groups, in points. Number |
chat.showTimestampsDefault true | Show message timestamps. Boolean |
chat.timestampFormatDefault "HH:mm" | Timestamp format (Unicode date pattern, e.g. "HH:mm:ss"). String |
chat.showJoinPartDefault "collapse" | How join, part, quit and nick changes are shown: show, collapse or hide. One of "show", "collapse", "hide" |
chat.colorNicksDefault true | Give each nick a stable color. Boolean |
chat.showAvatarsDefault false | Show initials avatars next to message groups in the grouped layout and member list. Boolean |
chat.groupingIntervalDefault 300 | Messages from the same sender within this many seconds are grouped. Number |
chat.columnsNickWidthDefault 120 | Nick column width in the columns layout, in points. Number |
chat.renderFormattingDefault true | Render mIRC formatting (colors, bold, italics). Off strips it. Boolean |
chat.largeEmojiDefault true | Show emoji-only messages larger. Boolean |
chat.scrollbackInMemoryDefault 1000 | Messages kept in memory per buffer; older ones are paged from disk. Integer |
chat.monospaceDefault false | Render chat text in chat.monospaceFontFamily, like a terminal client.Boolean |
Sidebar
| Setting | Description |
|---|---|
sidebar.collapsedDefault false | Hide the buffer sidebar. Boolean |
sidebar.widthDefault 200 | Sidebar width in points. Number |
sidebar.rowHeightDefault 22 | Sidebar row height in points. Number |
sidebar.fontSizeDefault 12 | Sidebar font size in points. Number |
sidebar.showUnreadCountsDefault true | Show unread message counts in the sidebar. Boolean |
Member list
| Setting | Description |
|---|---|
memberList.visibleDefault true | Show the channel member list. Boolean |
memberList.widthDefault 170 | Member list width in points. Number |
Media
| Setting | Description |
|---|---|
media.autoLoadDefault true | Load inline images automatically. Boolean |
media.showLinkCardsDefault true | Show preview cards for links. Boolean |
media.loadVideoEmbedsDefault true | Show embedded players for video links. Boolean |
media.blockedDomainsDefault [] | Never load media from these domains (and subdomains). Array of strings |
media.allowedDomainsDefault [] | Domains media may load from when media.restrictToAllowed is on.Array of strings |
media.restrictToAllowedDefault false | Only load media from domains listed in media.allowedDomains.Boolean |
media.maxImageSizeMBDefault 10 | Skip auto-loading images larger than this many megabytes. Number |
media.maxImageHeightDefault 320 | Maximum height of inline images, in points. Number |
media.disabledBuffersDefault [] | Buffers without inline media: "<networkUUID>/<foldedName>" or "<networkUUID>/*". Array of strings |
media.presentationDefault "full" | Inline preview size: full (cards, large images, players) or compact (title lines and thumbnails). One of "full", "compact" |
Notifications
| Setting | Description |
|---|---|
notifications.highlightsDefault true | Notify when you are mentioned or a highlight word matches. Boolean |
notifications.privateMessagesDefault true | Notify on private messages. Boolean |
notifications.soundDefault true | Play a sound with notifications. Boolean |
Highlights
| Setting | Description |
|---|---|
highlight.wordsDefault [] | Extra words that count as highlights on every network (your nick always does). Array of strings |
Input
| Setting | Description |
|---|---|
input.sendTypingIndicatorsDefault true | Let others see when you are typing (+typing). Boolean |
input.spellCheckDefault true | Check spelling while typing. Boolean |
Connection
| Setting | Description |
|---|---|
connection.autoReconnectDefault true | Reconnect automatically after a dropped connection. Boolean |
History
| Setting | Description |
|---|---|
history.retentionDaysDefault 0 | Delete stored messages older than this many days. 0 keeps history forever. Integer |
Navigation
| Setting | Description |
|---|---|
navigation.styleDefault "sidebar" | Navigate servers and channels with the sidebar or with tab stacks. One of "sidebar", "tabs" |
Tabs
| Setting | Description |
|---|---|
tabs.placementDefault "top" | Where tab stacks appear: top (below the title strip), titleBar or bottom (above the input). One of "top", "titleBar", "bottom" |
tabs.serverRowDefault "auto" | Show the server tab row always, or only when connected to more than one network (auto). One of "auto", "always" |
tabs.roundnessDefault 0.35 | Tab corner roundness from 0 (square) to 1 (pill). Number |
tabs.heightDefault 28 | Tab height in points. Number |
tabs.showUnreadBadgesDefault true | Show unread counts on tabs. Boolean |
tabs.showCloseButtonsDefault true | Show a close button on hover for channel and query tabs. Boolean |