| title | description | author | ms.author | ms.date | ms.topic |
|---|---|---|---|---|---|
Level up your Windows Terminal |
Notes from the "Level up your Windows Terminal" talk at Microsoft Build 2024 |
zadjii-msft |
chrnguyen |
5/14/2024 |
how-to |
For more info on configuring your profiles, see Profiles on Microsoft Learn.
This settings file customizes the new tab dropdown menu to include folders for the Terminal repos, all the WSLs, and Visual Studio. In the WSL folder, it includes all the Canonical fragment profiles as a separate dropdown nested within the WSL folder.
"newTabMenu":
[
{
"type": "remainingProfiles"
},
{
"allowEmpty": false,
"entries":
[
{ "profile": "{94ccc889-2f98-5c0c-9d14-912b02ecc59f}", "type": "profile" },
{ "profile": "{e492b1ac-cbf7-5299-b261-8ed4e330d74a}", "type": "profile" }
],
"icon": "%WT_SETTINGS_DIR%\\terminal\\res\\terminal.ico",
"inline": "never",
"name": "Terminal",
"type": "folder"
},
{
"allowEmpty": false,
"entries":
[
{ "source": "Windows.Terminal.Wsl", "type": "matchProfiles" },
{
"allowEmpty": false,
"entries":
[
{ "source": "CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc", "type": "matchProfiles" },
{ "source": "CanonicalGroupLimited.Ubuntu20.04onWindows_79rhkp1fndgsc", "type": "matchProfiles" },
{ "source": "CanonicalGroupLimited.Ubuntu22.04onWindows_79rhkp1fndgsc", "type": "matchProfiles" },
{ "source": "CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc", "type": "matchProfiles" }
],
"icon": null,
"inline": "never",
"name": "Canonical",
"type": "folder"
}
],
"icon": "ms-appx:///ProfileIcons/{9acb9455-ca41-5af7-950f-6bca1bc9722f}.png",
"inline": "never",
"name": "WSLs",
"type": "folder"
},
{
"allowEmpty": false,
"entries":
[
{ "source": "Windows.Terminal.VisualStudio", "type": "matchProfiles" },
{ "profile": "{da29b8a9-e007-5b35-a0d3-d7a869ae486e}", "type": "profile" }
],
"icon": null,
"inline": "never",
"name": "VS",
"type": "folder"
}
],See New tab dropdown
"theme": "Purple Titlebar",
"themes":
[
{
"name": "Purple Titlebar",
"tab":
{
"background": "terminalBackground",
"iconStyle": "default",
"showCloseButton": "always",
"unfocusedBackground": "#00000000"
},
"tabRow":
{
"background": "#5D50AE80",
"unfocusedBackground": "#202020FF"
},
"window":
{
"applicationTheme": "dark",
"experimental.rainbowFrame": true,
"frame": null,
"unfocusedFrame": null,
"useMica": true
}
}
],For more info on configuring your themes, see Themes
To replicate the prompt used in this demo, you can set your PROMPT variable to the following value:
$e]133;D$e\$e]133;A$e\$e]9;9;$P$e\$e[107;30m[$T]$e[97;46m$P$e[36;49m$e[0m$_$e[0m$e[94m%username%$e[0m@$e[32m%computername%$e[0m$G$e]133;B$e\This will also enable Shell
Integration.
Alternatively, you can use the cdd.cmd script in this repo to change the
prompt to also include the git branch. Just add that to your PATH somewhere and
use that instead of cd.
The easiest way to customize your PowerShell prompt is to use oh-my-posh. You can learn more here: oh-my-posh
Our example for creating multiple panes with different profiles all at once looked like the following:
{
"command":
{
"action": "multipleActions",
"actions":
[
{
"action": "newTab",
"colorScheme": "One Half Dark",
"profile": "Web Project"
},
{
"action": "splitPane",
"colorScheme": "Solarized Light",
"profile": "frontend",
"split": "right"
},
{
"action": "splitPane",
"colorScheme": "Campbell PowerShell",
"profile": "backend",
"split": "down",
"tabTitle": "Work"
}
]
},
"icon": "\ud83d\udcbb",
"keys": "ctrl+3",
"name": "Create My Workspace"
},In our examples, we've got three different profiles:
Web Projectfrontendbackend
and this will create a new tab with the Web Project profile, then split the
pane to the right with the frontend profile, and then split the pane down with
the backend profile.
Once we had those profiles open, we used the built-in toggleBroadcastInput
action to broadcast to all the panes at once.
For more info, see
To enable the right-click context menu, add the following to your settings:
"experimental.rightClickContextMenu": true,You can add that to individual profiles or to the defaults like so:
"profiles":
{
"defaults":
{
"experimental.rightClickContextMenu": true
// other settings here
},
"list": [
// profiles here
]For more info, see Right-click context menu
See Sudo for Windows for more info on how to use sudo in Windows 11.
Follow the guide at Shell Integration for how to enable shell integration for CMD, PowerShell, bash and other shells.
The following actions enable scrolling to prompts on Ctrl+Up and Ctrl+Down:
{ "command": { "action": "scrollToMark", "direction": "next" }, "keys": "ctrl+down" },
{ "command": { "action": "scrollToMark", "direction": "previous" }, "keys": "ctrl+up" },In this demo, we used two different keybindings to show suggestions. The first
will only show suggestions from the history, powered by shell integration. The
second will also show snippets (sendInput actions).
{
"command": { "action": "showSuggestions", "source": "commandHistory", "useCommandline": true },
"keys": "ctrl+shift+h"
},
{
"command": { "action": "showSuggestions", "source": "all", "useCommandline": true },
"keys": "ctrl+shift+y"
},For more info see showSuggestions
For an example of creating snippets, you can see our saved tar commands here:
{
"commands":
[
{
"command":
{
"action": "sendInput",
"input": "tar -xvzf {source.tar.gz}"
},
"name": "eXtract Ze File"
},
{
"command":
{
"action": "sendInput",
"input": "tar -xvzf {source.tar.gz} -C {destination_path}"
},
"name": "eXtract Ze File into path..."
},
{
"command":
{
"action": "sendInput",
"input": "tar -cvzf {destination.tar.gz} {source}"
},
"name": "Compress Ze File"
}
],
"name": "tar..."
}These will be nested under the tar... suggestion in the menu.