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 1 commit
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 -[term]`. Replace `[term]` by the terminal you want you use, such as `msys`, `ucrt64`, etc.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In this step, "term" and "terminal" should be replaced with "shell" or something similar. terminals are mintty, windows terminal etc.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please see commit c21df46.

* 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