1059 lines
39 KiB
JSON
1059 lines
39 KiB
JSON
{
|
|
"$id": "https://github.com/microsoft/terminal/blob/main/doc/cascadia/profiles.schema.json",
|
|
"$schema": "https://json-schema.org/draft/2019-09/schema#",
|
|
"title": "Microsoft's Windows Terminal Settings Profile Schema",
|
|
"definitions": {
|
|
"KeyChordSegment": {
|
|
"pattern": "^(?<modifier>(ctrl|alt|shift)(?:\\+(ctrl|alt|shift)(?<!\\2))?(?:\\+(ctrl|alt|shift)(?<!\\2|\\3))?\\+)?(?<key>[^\\s+]|app|menu|backspace|tab|enter|esc|escape|space|pgup|pageup|pgdn|pagedown|end|home|left|up|right|down|insert|delete|(?<!shift.+)(?:numpad_?[0-9]|numpad_(?:period|decimal))|numpad_(?:multiply|plus|add|minus|subtract|divide)|f[1-9]|f1[0-9]|f2[0-4]|plus)$",
|
|
"type": "string",
|
|
"description": "The string should fit the format \"[ctrl+][alt+][shift+]<keyName>\", where each modifier is optional, separated by + symbols, and keyName is either one of the names listed in the table below, or any single key character. The string should be written in full lowercase.\napp, menu\tMENU key\nbackspace\tBACKSPACE key\ntab\tTAB key\nenter\tENTER key\nesc, escape\tESC key\nspace\tSPACEBAR\npgup, pageup\tPAGE UP key\npgdn, pagedown\tPAGE DOWN key\nend\tEND key\nhome\tHOME key\nleft\tLEFT ARROW key\nup\tUP ARROW key\nright\tRIGHT ARROW key\ndown\tDOWN ARROW key\ninsert\tINS key\ndelete\tDEL key\nnumpad_0-numpad_9, numpad0-numpad9\tNumeric keypad keys 0 to 9. Can't be combined with the shift modifier.\nnumpad_multiply\tNumeric keypad MULTIPLY key (*)\nnumpad_plus, numpad_add\tNumeric keypad ADD key (+)\nnumpad_minus, numpad_subtract\tNumeric keypad SUBTRACT key (-)\nnumpad_period, numpad_decimal\tNumeric keypad DECIMAL key (.). Can't be combined with the shift modifier.\nnumpad_divide\tNumeric keypad DIVIDE key (/)\nf1-f24\tF1 to F24 function keys\nplus\tADD key (+)"
|
|
},
|
|
"Color": {
|
|
"default": "#",
|
|
"pattern": "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$",
|
|
"type": "string",
|
|
"format": "color"
|
|
},
|
|
"Coordinates": {
|
|
"pattern": "^(-?\\d+)?(,\\s?(-?\\d+)?)?$",
|
|
"type": "string"
|
|
},
|
|
"DynamicProfileSource": {
|
|
"enum": [
|
|
"Windows.Terminal.Wsl",
|
|
"Windows.Terminal.Azure",
|
|
"Windows.Terminal.PowershellCore"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"BellStyle": {
|
|
"enum": [
|
|
"none",
|
|
"audible"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"ProfileGuid": {
|
|
"default": "{}",
|
|
"pattern": "^\\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\\}$",
|
|
"type": "string"
|
|
},
|
|
"Icon": {
|
|
"description": "Image file location or an emoji to be used as an icon. Displays within the tab, the dropdown menu, and jumplist.",
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"ShortcutActionName": {
|
|
"enum": [
|
|
"adjustFontSize",
|
|
"closeOtherTabs",
|
|
"closePane",
|
|
"closeTab",
|
|
"closeTabsAfter",
|
|
"closeWindow",
|
|
"commandPalette",
|
|
"copy",
|
|
"duplicateTab",
|
|
"find",
|
|
"moveFocus",
|
|
"newTab",
|
|
"nextTab",
|
|
"openNewTabDropdown",
|
|
"openSettings",
|
|
"openTabColorPicker",
|
|
"paste",
|
|
"prevTab",
|
|
"renameTab",
|
|
"resetFontSize",
|
|
"resizePane",
|
|
"scrollDown",
|
|
"scrollDownPage",
|
|
"scrollUp",
|
|
"scrollUpPage",
|
|
"sendInput",
|
|
"setColorScheme",
|
|
"setTabColor",
|
|
"splitPane",
|
|
"switchToTab",
|
|
"tabSearch",
|
|
"toggleAlwaysOnTop",
|
|
"toggleFocusMode",
|
|
"toggleFullscreen",
|
|
"togglePaneZoom",
|
|
"toggleRetroEffect",
|
|
"wt",
|
|
"unbound"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"Direction": {
|
|
"enum": [
|
|
"left",
|
|
"right",
|
|
"up",
|
|
"down"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"SplitState": {
|
|
"enum": [
|
|
"vertical",
|
|
"horizontal",
|
|
"auto"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"CopyFormat": {
|
|
"oneOf": [
|
|
{
|
|
"type": "boolean"
|
|
},
|
|
{
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": [
|
|
"html",
|
|
"rtf"
|
|
]
|
|
}
|
|
},
|
|
{
|
|
"type": "string",
|
|
"enum": [
|
|
"html",
|
|
"rtf",
|
|
"all",
|
|
"none"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
"AnchorKey": {
|
|
"enum": [
|
|
"ctrl",
|
|
"alt",
|
|
"shift"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"NewTerminalArgs": {
|
|
"properties": {
|
|
"commandline": {
|
|
"description": "A commandline to use instead of the profile's",
|
|
"type": "string"
|
|
},
|
|
"tabTitle": {
|
|
"description": "An initial tabTitle to use instead of the profile's",
|
|
"type": "string"
|
|
},
|
|
"startingDirectory": {
|
|
"description": "A startingDirectory to use instead of the profile's",
|
|
"type": "string"
|
|
},
|
|
"profile": {
|
|
"description": "Either the GUID or name of a profile to use, instead of launching the default",
|
|
"type": "string"
|
|
},
|
|
"index": {
|
|
"type": "integer",
|
|
"description": "The index of the profile in the new tab dropdown (starting at 0)"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"ShortcutAction": {
|
|
"properties": {
|
|
"action": {
|
|
"description": "The action to execute",
|
|
"$ref": "#/definitions/ShortcutActionName"
|
|
}
|
|
},
|
|
"required": [
|
|
"action"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"AdjustFontSizeAction": {
|
|
"description": "Arguments corresponding to an Adjust Font Size Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "adjustFontSize" },
|
|
"delta": {
|
|
"type": "integer",
|
|
"default": 0,
|
|
"description": "How much to change the current font point size"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "delta" ]
|
|
},
|
|
"CopyAction": {
|
|
"description": "Arguments corresponding to a Copy Text Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "copy" },
|
|
"singleLine": {
|
|
"type": "boolean",
|
|
"default": false,
|
|
"description": "If true, the copied content will be copied as a single line (even if there are hard line breaks present in the text). If false, newlines persist from the selected text."
|
|
},
|
|
"copyFormatting": {
|
|
"default": null,
|
|
"description": "When set to `true`, the color and font formatting of selected text is also copied to your clipboard. When set to `false`, only plain text is copied to your clipboard. An array of specific formats can also be used. Supported array values include `html` and `rtf`. Plain text is always copied. Not setting this value inherits the behavior of the `copyFormatting` global setting.",
|
|
"oneOf": [
|
|
{
|
|
"$ref": "#/definitions/CopyFormat"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"NewTabAction": {
|
|
"description": "Arguments corresponding to a New Tab Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{ "$ref": "#/definitions/NewTerminalArgs" },
|
|
{
|
|
"properties": {
|
|
"action": { "type":"string", "pattern": "newTab" }
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"SwitchToTabAction": {
|
|
"description": "Arguments corresponding to a Switch To Tab Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "switchToTab" },
|
|
"index": {
|
|
"type": "integer",
|
|
"default": 0,
|
|
"description": "Which tab to switch to, with the first being 0"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "index" ]
|
|
},
|
|
"MoveFocusAction": {
|
|
"description": "Arguments corresponding to a Move Focus Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "moveFocus" },
|
|
"direction": {
|
|
"$ref": "#/definitions/Direction",
|
|
"default": "left",
|
|
"description": "The direction to move focus in, between panes"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "direction" ]
|
|
},
|
|
"ResizePaneAction": {
|
|
"description": "Arguments corresponding to a Resize Pane Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "resizePane" },
|
|
"direction": {
|
|
"$ref": "#/definitions/Direction",
|
|
"default": "left",
|
|
"description": "The direction to move the pane separator in"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "direction" ]
|
|
},
|
|
"SendInputAction": {
|
|
"description": "Arguments corresponding to a Send Input Action",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/definitions/ShortcutAction"
|
|
},
|
|
{
|
|
"properties": {
|
|
"action": {
|
|
"type": "string",
|
|
"pattern": "sendInput"
|
|
},
|
|
"input": {
|
|
"type": "string",
|
|
"default": "",
|
|
"description": "The text input to feed into the shell. ANSI escape sequences may be used. Escape codes like \\x1b must be written as \\u001b."
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "input" ]
|
|
},
|
|
"SplitPaneAction": {
|
|
"description": "Arguments corresponding to a Split Pane Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{ "$ref": "#/definitions/NewTerminalArgs" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "splitPane" },
|
|
"split": {
|
|
"$ref": "#/definitions/SplitState",
|
|
"default": "auto",
|
|
"description": "The orientation to split the pane in. Possible values:\n -\"auto\" (splits pane based on remaining space)\n -\"horizontal\" (think [-])\n -\"vertical\" (think [|])"
|
|
},
|
|
"splitMode": {
|
|
"default": "duplicate",
|
|
"description": "Control how the pane splits. Only accepts \"duplicate\" which will duplicate the focused pane's profile into a new pane."
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"OpenSettingsAction": {
|
|
"description": "Arguments corresponding to a Open Settings Action",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/definitions/ShortcutAction"
|
|
},
|
|
{
|
|
"properties": {
|
|
"action": {
|
|
"type": "string",
|
|
"pattern": "openSettings"
|
|
},
|
|
"target": {
|
|
"type": "string",
|
|
"default": "settingsFile",
|
|
"description": "The settings file to open.",
|
|
"enum": [
|
|
"settingsFile",
|
|
"defaultsFile",
|
|
"allFiles"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"SetTabColorAction": {
|
|
"description": "Arguments corresponding to a Set Tab Color Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "setTabColor" },
|
|
"color": {
|
|
"$ref": "#/definitions/Color",
|
|
"default": null,
|
|
"description": "If provided, will set the tab's color to the given value. If omitted, will reset the tab's color."
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"SetColorSchemeAction": {
|
|
"description": "Arguments corresponding to a Set Color Scheme Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "setColorScheme" },
|
|
"colorScheme": {
|
|
"type": "string",
|
|
"default": "",
|
|
"description": "the name of the scheme to apply to the active pane"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "colorScheme" ]
|
|
},
|
|
"WtAction": {
|
|
"description": "Arguments corresponding to a wt Action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "wt" },
|
|
"commandline": {
|
|
"type": "string",
|
|
"default": "",
|
|
"description": "a `wt` commandline to run in the current window"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"required": [ "commandline" ]
|
|
},
|
|
"CloseOtherTabsAction": {
|
|
"description": "Arguments for a closeOtherTabs action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "closeOtherTabs" },
|
|
"index": {
|
|
"oneOf": [
|
|
{ "type": "integer" },
|
|
{ "type": null }
|
|
],
|
|
"default": "",
|
|
"description": "Close the tabs other than the one at this index. If no index is provided, use the focused tab's index."
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"CloseTabsAfterAction": {
|
|
"description": "Arguments for a closeTabsAfter action",
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/ShortcutAction" },
|
|
{
|
|
"properties": {
|
|
"action": { "type": "string", "pattern": "closeTabsAfter" },
|
|
"index": {
|
|
"oneOf": [
|
|
{ "type": "integer" },
|
|
{ "type": null }
|
|
],
|
|
"default": "",
|
|
"description": "Close the tabs following the tab at this index. If no index is provided, use the focused tab's index."
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"Keybinding": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"command": {
|
|
"description": "The action executed when the associated key bindings are pressed.",
|
|
"oneOf": [
|
|
{ "$ref": "#/definitions/AdjustFontSizeAction" },
|
|
{ "$ref": "#/definitions/CopyAction" },
|
|
{ "$ref": "#/definitions/ShortcutActionName" },
|
|
{ "$ref": "#/definitions/NewTabAction" },
|
|
{ "$ref": "#/definitions/SwitchToTabAction" },
|
|
{ "$ref": "#/definitions/MoveFocusAction" },
|
|
{ "$ref": "#/definitions/ResizePaneAction" },
|
|
{ "$ref": "#/definitions/SendInputAction" },
|
|
{ "$ref": "#/definitions/SplitPaneAction" },
|
|
{ "$ref": "#/definitions/OpenSettingsAction" },
|
|
{ "$ref": "#/definitions/SetTabColorAction" },
|
|
{ "$ref": "#/definitions/SetColorSchemeAction" },
|
|
{ "$ref": "#/definitions/WtAction" },
|
|
{ "$ref": "#/definitions/CloseOtherTabsAction" },
|
|
{ "$ref": "#/definitions/CloseTabsAfterAction" },
|
|
{ "type": "null" }
|
|
]
|
|
},
|
|
"keys": {
|
|
"description": "Defines the key combinations used to call the command. It must be composed of...\n -any number of modifiers (ctrl/alt/shift)\n -a non-modifier key",
|
|
"oneOf": [
|
|
{
|
|
"$ref": "#/definitions/KeyChordSegment"
|
|
},
|
|
{
|
|
"items": {
|
|
"$ref": "#/definitions/KeyChordSegment"
|
|
},
|
|
"minItems": 1,
|
|
"type": "array"
|
|
}
|
|
]
|
|
},
|
|
"icon": { "$ref": "#/definitions/Icon" },
|
|
"name": {
|
|
"description": "The name that will appear in the command palette. If one isn't provided, the terminal will attempt to automatically generate a name.",
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"command",
|
|
"keys"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Globals": {
|
|
"additionalProperties": true,
|
|
"description": "Properties that affect the entire window, regardless of the profile settings.",
|
|
"properties": {
|
|
"alwaysOnTop": {
|
|
"default": false,
|
|
"description": "When set to true, the window is created on top of all other windows. If multiple windows are all \"always on top\", the most recently focused one will be the topmost",
|
|
"type": "boolean"
|
|
},
|
|
"alwaysShowTabs": {
|
|
"default": true,
|
|
"description": "When set to true, tabs are always displayed. When set to false and \"showTabsInTitlebar\" is set to false, tabs only appear after opening a new tab.",
|
|
"type": "boolean"
|
|
},
|
|
"copyOnSelect": {
|
|
"default": false,
|
|
"description": "When set to true, a selection is immediately copied to your clipboard upon creation. When set to false, the selection persists and awaits further action.",
|
|
"type": "boolean"
|
|
},
|
|
"copyFormatting": {
|
|
"default": true,
|
|
"description": "When set to `true`, the color and font formatting of selected text is also copied to your clipboard. When set to `false`, only plain text is copied to your clipboard. An array of specific formats can also be used. Supported array values include `html` and `rtf`. Plain text is always copied.",
|
|
"$ref": "#/definitions/CopyFormat"
|
|
},
|
|
"disableAnimations": {
|
|
"default": false,
|
|
"description": "When set to `true`, visual animations will be disabled across the application.",
|
|
"type": "boolean"
|
|
},
|
|
"largePasteWarning": {
|
|
"default": true,
|
|
"description": "When set to true, trying to paste text with more than 5 KiB of characters will display a warning asking you whether to continue or not with the paste.",
|
|
"type": "boolean"
|
|
},
|
|
"multiLinePasteWarning": {
|
|
"default": true,
|
|
"description": "When set to true, trying to paste text with a \"new line\" character will display a warning asking you whether to continue or not with the paste.",
|
|
"type": "boolean"
|
|
},
|
|
"defaultProfile": {
|
|
"description": "Sets the default profile. Opens by clicking the \"+\" icon or typing the key binding assigned to \"newTab\".",
|
|
"type": "string"
|
|
},
|
|
"disabledProfileSources": {
|
|
"description": "Disables all the dynamic profile generators in this list, preventing them from adding their profiles to the list of profiles on startup.",
|
|
"items": {
|
|
"$ref": "#/definitions/DynamicProfileSource"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"experimental.rendering.forceFullRepaint": {
|
|
"description": "When set to true, we will redraw the entire screen each frame. When set to false, we will render only the updates to the screen between frames.",
|
|
"type": "boolean"
|
|
},
|
|
"experimental.rendering.software": {
|
|
"description": "When set to true, we will use the software renderer (a.k.a. WARP) instead of the hardware one.",
|
|
"type": "boolean"
|
|
},
|
|
"initialCols": {
|
|
"default": 120,
|
|
"description": "The number of columns displayed in the window upon first load. If \"launchMode\" is set to \"maximized\" (or \"maximizedFocus\"), this property is ignored.",
|
|
"maximum": 999,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"initialPosition": {
|
|
"$ref": "#/definitions/Coordinates",
|
|
"description": "The position of the top left corner of the window upon first load. On a system with multiple displays, these coordinates are relative to the top left of the primary display. If \"launchMode\" is set to \"maximized\" (or \"maximizedFocus\"), the window will be maximized on the monitor specified by those coordinates."
|
|
},
|
|
"initialRows": {
|
|
"default": 30,
|
|
"description": "The number of rows displayed in the window upon first load. If \"launchMode\" is set to \"maximized\" (or \"maximizedFocus\"), this property is ignored.",
|
|
"maximum": 999,
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"startOnUserLogin": {
|
|
"default": false,
|
|
"description": "When set to true, this enables the launch of Windows Terminal at startup. Setting this to false will disable the startup task entry. If the Windows Terminal startup task entry is disabled either by org policy or by user action this setting will have no effect.",
|
|
"type": "boolean"
|
|
},
|
|
"launchMode": {
|
|
"default": "default",
|
|
"description": "Defines whether the terminal will launch as maximized, full screen, or in a window. Setting this to \"focus\" is equivalent to launching the terminal in the \"default\" mode, but with the focus mode enabled. Similar, setting this to \"maximizedFocus\" will result in launching the terminal in a maximized window with the focus mode enabled.",
|
|
"enum": [
|
|
"fullscreen",
|
|
"maximized",
|
|
"default",
|
|
"focus",
|
|
"maximizedFocus"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"rowsToScroll": {
|
|
"default": "system",
|
|
"description": "This parameter once allowed you to override the systemwide \"choose how many lines to scroll at one time\" setting. It no longer does so.",
|
|
"maximum": 999,
|
|
"minimum": 0,
|
|
"type": [ "integer", "string" ],
|
|
"deprecated": true
|
|
},
|
|
"keybindings": {
|
|
"description": "Properties are specific to each custom key binding.",
|
|
"items": {
|
|
"$ref": "#/definitions/Keybinding"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"theme": {
|
|
"default": "system",
|
|
"description": "Sets the theme of the application. The special value \"system\" refers to the active Windows system theme.",
|
|
"enum": [
|
|
"light",
|
|
"dark",
|
|
"system"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"showTabsInTitlebar": {
|
|
"default": true,
|
|
"description": "When set to true, the tabs are moved into the titlebar and the titlebar disappears. When set to false, the titlebar sits above the tabs.",
|
|
"type": "boolean"
|
|
},
|
|
"showTerminalTitleInTitlebar": {
|
|
"default": true,
|
|
"description": "When set to true, titlebar displays the title of the selected tab. When set to false, titlebar displays \"Windows Terminal\".",
|
|
"type": "boolean"
|
|
},
|
|
"snapToGridOnResize": {
|
|
"default": false,
|
|
"description": "When set to true, the window will snap to the nearest character boundary on resize. When false, the window will resize smoothly",
|
|
"type": "boolean"
|
|
},
|
|
"tabWidthMode": {
|
|
"default": "equal",
|
|
"description": "Sets the width of the tabs. Possible values include:\n -\"equal\" sizes each tab to the same width\n -\"titleLength\" sizes each tab to the length of its title\n -\"compact\" sizes each tab to the length of its title when focused, and shrinks to the size of only the icon when the tab is unfocused.",
|
|
"enum": [
|
|
"compact",
|
|
"equal",
|
|
"titleLength"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"wordDelimiters": {
|
|
"default": " ./\\()\"'-:,.;<>~!@#$%^&*|+=[]{}~?│",
|
|
"description": "Determines the delimiters used in a double click selection.",
|
|
"type": "string"
|
|
},
|
|
"confirmCloseAllTabs": {
|
|
"default": true,
|
|
"description": "When set to \"true\" closing a window with multiple tabs open will require confirmation. When set to \"false\", the confirmation dialog will not appear.",
|
|
"type": "boolean"
|
|
},
|
|
"useTabSwitcher": {
|
|
"default": true,
|
|
"description": "When set to \"true\", the \"nextTab\" and \"prevTab\" commands will use the tab switcher UI.",
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"defaultProfile"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"Profile": {
|
|
"description": "Properties specific to a unique profile.",
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"acrylicOpacity": {
|
|
"default": 0.5,
|
|
"description": "When useAcrylic is set to true, it sets the transparency of the window for the profile. Accepts floating point values from 0-1 (default 0.5).",
|
|
"maximum": 1,
|
|
"minimum": 0,
|
|
"type": "number"
|
|
},
|
|
"antialiasingMode": {
|
|
"default": "grayscale",
|
|
"description": "Controls how text is antialiased in the renderer. Possible values are \"grayscale\", \"cleartype\" and \"aliased\". Note that changing this setting will require starting a new terminal instance.",
|
|
"enum": [
|
|
"grayscale",
|
|
"cleartype",
|
|
"aliased"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"background": {
|
|
"$ref": "#/definitions/Color",
|
|
"default": "#0c0c0c",
|
|
"description": "Sets the background color of the text. Overrides \"background\" from the color scheme. Uses hex color format: \"#rrggbb\".",
|
|
"type": ["string", "null"]
|
|
},
|
|
"backgroundImage": {
|
|
"description": "Sets the file location of the image to draw over the window background.",
|
|
"type": ["string", "null"]
|
|
},
|
|
"backgroundImageAlignment": {
|
|
"default": "center",
|
|
"enum": [
|
|
"bottom",
|
|
"bottomLeft",
|
|
"bottomRight",
|
|
"center",
|
|
"left",
|
|
"right",
|
|
"top",
|
|
"topLeft",
|
|
"topRight"
|
|
],
|
|
"description": "Sets how the background image aligns to the boundaries of the window. Possible values: \"center\", \"left\", \"top\", \"right\", \"bottom\", \"topLeft\", \"topRight\", \"bottomLeft\", \"bottomRight\"",
|
|
"type": "string"
|
|
},
|
|
"backgroundImageOpacity": {
|
|
"default": 1.0,
|
|
"description": "Sets the transparency of the background image. Accepts floating point values from 0-1.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"backgroundImageStretchMode": {
|
|
"default": "uniformToFill",
|
|
"description": "Sets how the background image is resized to fill the window.",
|
|
"enum": [
|
|
"fill",
|
|
"none",
|
|
"uniform",
|
|
"uniformToFill"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"bellStyle": {
|
|
"default": "audible",
|
|
"description": "Controls what happens when the application emits a BEL character. When set to \"audible\", the Terminal will play a sound. When set to \"none\", nothing will happen.",
|
|
"$ref": "#/definitions/BellStyle"
|
|
},
|
|
"closeOnExit": {
|
|
"default": "graceful",
|
|
"description": "Sets how the profile reacts to termination or failure to launch. Possible values:\n -\"graceful\" (close when exit is typed or the process exits normally)\n -\"always\" (always close)\n -\"never\" (never close).\ntrue and false are accepted as synonyms for \"graceful\" and \"never\" respectively.",
|
|
"oneOf": [
|
|
{
|
|
"enum": [
|
|
"never",
|
|
"graceful",
|
|
"always"
|
|
],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "boolean"
|
|
}
|
|
]
|
|
},
|
|
"colorScheme": {
|
|
"default": "Campbell",
|
|
"description": "Name of the terminal color scheme to use. Color schemes are defined under \"schemes\".",
|
|
"type": "string"
|
|
},
|
|
"commandline": {
|
|
"description": "Executable used in the profile.",
|
|
"type": "string"
|
|
},
|
|
"cursorColor": {
|
|
"oneOf": [
|
|
{ "$ref": "#/definitions/Color" },
|
|
{"type": "null"}
|
|
],
|
|
"description": "Sets the color of the cursor. Overrides the cursor color from the color scheme. Uses hex color format: \"#rrggbb\"."
|
|
},
|
|
"cursorHeight": {
|
|
"description": "Sets the percentage height of the cursor starting from the bottom. Only works when cursorShape is set to \"vintage\". Accepts values from 25-100.",
|
|
"maximum": 100,
|
|
"minimum": 25,
|
|
"type": ["integer","null"],
|
|
"default": 25
|
|
},
|
|
"cursorShape": {
|
|
"default": "bar",
|
|
"description": "Sets the shape of the cursor. Possible values:\n -\"bar\" ( ┃, default )\n -\"emptyBox\" ( ▯ )\n -\"filledBox\" ( █ )\n -\"underscore\" ( ▁ )\n -\"vintage\" ( ▃ )",
|
|
"enum": [
|
|
"bar",
|
|
"emptyBox",
|
|
"filledBox",
|
|
"underscore",
|
|
"vintage"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"experimental.retroTerminalEffect": {
|
|
"description": "When set to true, enable retro terminal effects. This is an experimental feature, and its continued existence is not guaranteed.",
|
|
"type": "boolean"
|
|
},
|
|
"fontFace": {
|
|
"default": "Cascadia Mono",
|
|
"description": "Name of the font face used in the profile.",
|
|
"type": "string"
|
|
},
|
|
"fontSize": {
|
|
"default": 12,
|
|
"description": "Size of the font in points.",
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"fontWeight": {
|
|
"default": "normal",
|
|
"description": "Sets the weight (lightness or heaviness of the strokes) for the given font. Possible values:\n -\"thin\"\n -\"extra-light\"\n -\"light\"\n -\"semi-light\"\n -\"normal\" (default)\n -\"medium\"\n -\"semi-bold\"\n -\"bold\"\n -\"extra-bold\"\n -\"black\"\n -\"extra-black\" or the corresponding numeric representation of OpenType font weight.",
|
|
"oneOf": [
|
|
{
|
|
"enum": [
|
|
"thin",
|
|
"extra-light",
|
|
"light",
|
|
"semi-light",
|
|
"normal",
|
|
"medium",
|
|
"semi-bold",
|
|
"bold",
|
|
"extra-bold",
|
|
"black",
|
|
"extra-black"
|
|
],
|
|
"type": "string"
|
|
},
|
|
{
|
|
"maximum": 990,
|
|
"minimum": 100,
|
|
"type": "integer"
|
|
}
|
|
]
|
|
},
|
|
"foreground": {
|
|
"$ref": "#/definitions/Color",
|
|
"default": "#cccccc",
|
|
"description": "Sets the text color. Overrides \"foreground\" from the color scheme. Uses hex color format: \"#rrggbb\".",
|
|
"type": ["string", "null"]
|
|
},
|
|
"guid": {
|
|
"$ref": "#/definitions/ProfileGuid",
|
|
"description": "Unique identifier of the profile. Written in registry format: \"{00000000-0000-0000-0000-000000000000}\"."
|
|
},
|
|
"hidden": {
|
|
"default": false,
|
|
"description": "If set to true, the profile will not appear in the list of profiles. This can be used to hide default profiles and dynamically generated profiles, while leaving them in your settings file.",
|
|
"type": "boolean"
|
|
},
|
|
"historySize": {
|
|
"default": 9001,
|
|
"description": "The number of lines above the ones displayed in the window you can scroll back to.",
|
|
"minimum": -1,
|
|
"type": "integer"
|
|
},
|
|
"icon":{ "$ref": "#/definitions/Icon" },
|
|
"name": {
|
|
"description": "Name of the profile. Displays in the dropdown menu.",
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"padding": {
|
|
"default": "8, 8, 8, 8",
|
|
"description": "Sets the padding around the text within the window. Can have three different formats:\n -\"#\" sets the same padding for all sides \n -\"#, #\" sets the same padding for left-right and top-bottom\n -\"#, #, #, #\" sets the padding individually for left, top, right, and bottom.",
|
|
"oneOf": [
|
|
{
|
|
"pattern": "^-?[0-9]+(\\.[0-9]+)?( *, *-?[0-9]+(\\.[0-9]+)?|( *, *-?[0-9]+(\\.[0-9]+)?){3})?$",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"type": "integer"
|
|
}
|
|
]
|
|
},
|
|
"scrollbarState": {
|
|
"default": "visible",
|
|
"description": "Defines the visibility of the scrollbar.",
|
|
"enum": [
|
|
"visible",
|
|
"hidden"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"selectionBackground": {
|
|
"oneOf": [
|
|
{"$ref": "#/definitions/Color"},
|
|
{ "type": "null" }
|
|
],
|
|
"description": "Sets the background color of selected text. Overrides selectionBackground set in the color scheme. Uses hex color format: \"#rrggbb\"."
|
|
},
|
|
"snapOnInput": {
|
|
"default": true,
|
|
"description": "When set to true, the window will scroll to the command input line when typing. When set to false, the window will not scroll when you start typing.",
|
|
"type": "boolean"
|
|
},
|
|
"altGrAliasing": {
|
|
"default": true,
|
|
"description": "By default Windows treats Ctrl+Alt as an alias for AltGr. When altGrAliasing is set to false, this behavior will be disabled.",
|
|
"type": "boolean"
|
|
},
|
|
"source": {
|
|
"description": "Stores the name of the profile generator that originated this profile.",
|
|
"type": ["string", "null"]
|
|
},
|
|
"startingDirectory": {
|
|
"description": "The directory the shell starts in when it is loaded.",
|
|
"type": "string"
|
|
},
|
|
"suppressApplicationTitle": {
|
|
"description": "When set to true, tabTitle overrides the default title of the tab and any title change messages from the application will be suppressed. When set to false, tabTitle behaves as normal.",
|
|
"type": "boolean",
|
|
"default": false
|
|
},
|
|
"tabTitle": {
|
|
"description": "If set, will replace the name as the title to pass to the shell on startup. Some shells (like bash) may choose to ignore this initial value, while others (cmd, powershell) may use this value over the lifetime of the application.",
|
|
"type": ["string", "null"]
|
|
},
|
|
"useAcrylic": {
|
|
"default": false,
|
|
"description": "When set to true, the window will have an acrylic background. When set to false, the window will have a plain, untextured background.",
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"ProfileList": {
|
|
"description": "A list of profiles and the properties specific to each.",
|
|
"items": {
|
|
"$ref": "#/definitions/Profile",
|
|
"required": [
|
|
"guid",
|
|
"name"
|
|
]
|
|
},
|
|
"type": "array"
|
|
},
|
|
"ProfilesObject": {
|
|
"description": "A list of profiles and default settings that apply to all of them",
|
|
"properties": {
|
|
"list": {
|
|
"$ref": "#/definitions/ProfileList"
|
|
},
|
|
"defaults": {
|
|
"description": "The default settings that apply to every profile.",
|
|
"$ref": "#/definitions/Profile"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"SchemeList": {
|
|
"description": "Properties are specific to each color scheme. ColorTool is a great tool you can use to create and explore new color schemes. All colors use hex color format.",
|
|
"items": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"name": {
|
|
"description": "Name of the color scheme.",
|
|
"minLength": 1,
|
|
"type": "string"
|
|
},
|
|
"background": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the background color of the color scheme."
|
|
},
|
|
"black": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI black."
|
|
},
|
|
"blue": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI blue."
|
|
},
|
|
"brightBlack": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright black."
|
|
},
|
|
"brightBlue": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright blue."
|
|
},
|
|
"brightCyan": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright cyan."
|
|
},
|
|
"brightGreen": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright green."
|
|
},
|
|
"brightPurple": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright purple."
|
|
},
|
|
"brightRed": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright red."
|
|
},
|
|
"brightWhite": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright white."
|
|
},
|
|
"brightYellow": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI bright yellow."
|
|
},
|
|
"cursorColor": {
|
|
"$ref": "#/definitions/Color",
|
|
"default": "#FFFFFF",
|
|
"description": "Sets the cursor color of the color scheme."
|
|
},
|
|
"cyan": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI cyan."
|
|
},
|
|
"foreground": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the foreground color of the color scheme."
|
|
},
|
|
"green": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI green."
|
|
},
|
|
"purple": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI purple."
|
|
},
|
|
"red": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI red."
|
|
},
|
|
"selectionBackground": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the selection background color of the color scheme."
|
|
},
|
|
"white": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI white."
|
|
},
|
|
"yellow": {
|
|
"$ref": "#/definitions/Color",
|
|
"description": "Sets the color used as ANSI yellow."
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
}
|
|
},
|
|
"allOf": [
|
|
{ "$ref": "#/definitions/Globals" },
|
|
{
|
|
"additionalItems": true,
|
|
"properties": {
|
|
"profiles": {
|
|
"oneOf": [
|
|
{ "$ref": "#/definitions/ProfileList" },
|
|
{ "$ref": "#/definitions/ProfilesObject" }
|
|
]
|
|
},
|
|
"schemes": { "$ref": "#/definitions/SchemeList" }
|
|
},
|
|
"required": [
|
|
"profiles",
|
|
"schemes",
|
|
"defaultProfile"
|
|
]
|
|
}
|
|
]
|
|
}
|