Gautam Naik cfbc9e8f9f Added fontSize and acrylicOpacity changing tip (#1889 )

* Added fontSize and acrylicOpacity changing tip

Added Terminal tip about changing the font size and acrylic opacity using keyboard shortcuts.

* Update index.md

2019-07-09 12:19:06 -07:00

3.3 KiB

Raw Blame History

Windows Terminal User Documentation

NOTE: At the time of writing Windows Terminal is still under active development and many things will change. If you notice an error in the docs, please raise an issue. Or better yet, please file a PR with an appropriate update!

Installing Windows Terminal

From Source Code

Follow the instructions in this repo's README.

From the Microsoft Store

Make sure you have upgraded to the current Windows 10 release (at least 1903)
Search for Windows Terminal in the Store
Review the minimum system settings to ensure you can successfully install Windows Terminal
Install in the normal fashion

Starting Windows Terminal

From the Windows Start menu, select Windows Terminal and run the application.

Note: You can right click on the application item and run with Windows Administrator privilege if required.

The default shell is PowerShell.

Command line options

None at this time. See issue #607

Multiple Tabs

Additional shells can be started by hitting the + button from the tab bar -- a new instance of the default shell is displayed (default shortcut Ctrl+Shift+1).

Running a Different Shell

Note: The following text assumes you have WSL installed.

To choose a different shell (e.g. cmd.exe or WSL bash) then

Select the down button next to the + in the tab bar
Choose your new shell from the list (more on how to extend the list in the config section)

Starting a new PowerShell tab with admin privilege

There is no current plan to support this feature for security reaons. See issue #623

Using cut and paste in the Terminal window

With PowerShell

Copy - Select the text with mouse (default left button), then right click with mouse
Paste - by default use <ctrl>+v>, or right click with mouse

With Bash

Copy - Select the text with mouse (default left button), then right click with mouse
Paste - Right click with mouse

Add a "Open Windows Terminal Here" to File Explorer

Not currently supported "out of the box". See issue #1060

Configuring Windows Terminal

At the time of writing all Windows Terminal settings are managed via a json file.

From the down button in the top bar select Settings (default shortcut Ctrl+,).

Your default json editor will open up the Terminal settings file. The file can be found at $env:LocalAppData\Packages\Microsoft.WindowsTerminal_<randomString>/RoamingState

An introduction to the the various settings can be found here.

The list of valid settings can be found in the Profiles.json Documentation doc.

Tips and Tricks:

In PowerShell you can discover if the Windows Terminal is being used by checking for the existence of the environment variable WT_SESSION.

Under pwsh you can also use (Get-Process -Id $pid).Parent.Parent.ProcessName -eq 'WindowsTerminal'

(ref https://twitter.com/r_keith_hill/status/1142871145852440576)
Terminal zoom can be changed by holding Ctrl and scrolling with mouse.
If useAcrylic is enabled in profiles.json, background opacity can be changed by holding Ctrl+Shift and scrolling with mouse.
Please add more Tips and Tricks

3.3 KiB Raw Blame History