Skip to content

Update terminals.md to document the GUI of the settings of the Windows Terminal #404

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update terminals.md to document the GUI of the settings of the Windows Terminal #404

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b7def42
Update terminals.md to document the GUI of the settings of the Window…
eliotttak Oct 3, 2025
c21df46
As said @Biswa96, I replaced "term" and "terminal" by "shell".
eliotttak Oct 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 6 additions & 53 deletions web/docs/terminals.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,64 +32,17 @@ and WSL can also be extended to support a MSYS2 shell.

* Get it via the [Windows app store](https://aka.ms/terminal) if you don't have
it installed already.
* In the tab dropdown menu select "Settings" which opens a code editor showing
a JSON configuration file.
* Insert the example profiles shown below under the `profiles` key. Note that
* In the tab dropdown menu select "Settings" which opens a settings page
* In the left sidebar, click on "+ Add a new profile" under "Profiles". Note that
the examples assume that you have MSYS2 installed under `C:\msys64`.
* You can make one of the MSYS2 profiles the default by setting the `defaultProfile`
key to the `guid` value of one of the profile entries.
* In the opened page, click on "+ New empty profile".
* Under Name, enter "MSYS" (or the name you want)
* Under Command line, enter `C:/msys64/msys2_shell.cmd -defterm -no-start -[shell]`. Replace `[shell]` by the shell you want you use, such as `msys`, `ucrt64`, etc.
* Click on "Save changes".

For more info on the different profile settings see
https://docs.microsoft.com/en-us/windows/terminal/customize-settings/profile-settings <br style="clear:both"/>

```json
// This makes UCRT64 the default shell
"defaultProfile": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
"profiles": {
"list":
[
// ...
{
"guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
"name": "UCRT64 / MSYS2",
"commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -ucrt64",
"startingDirectory": "C:/msys64/home/%USERNAME%",
"icon": "C:/msys64/ucrt64.ico",
"font":
{
"face": "Lucida Console",
"size": 9
}
},
{
"guid": "{71160544-14d8-4194-af25-d05feeac7233}",
"name": "MSYS / MSYS2",
"commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -msys",
"startingDirectory": "C:/msys64/home/%USERNAME%",
"icon": "C:/msys64/msys2.ico",
"font":
{
"face": "Lucida Console",
"size": 9
}
},
// ...
]
}
```

* The `commandline` in that profile will launch bash shell by default. To change
default login shell, install the corresponding package for that shell and append
`-shell` option with the command line. For example,
- To set `fish` shell as default:
```
"commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -ucrt64 -shell fish"
```
- To set `zsh` shell as default:
```
"commandline": "C:/msys64/msys2_shell.cmd -defterm -here -no-start -ucrt64 -shell zsh"
```

## Konsole

![image](konsole.png){: align=right width=45% }
Expand Down