diff --git a/TerminalDocs/custom-terminal-gallery/custom-schemes.md b/TerminalDocs/custom-terminal-gallery/custom-schemes.md index 4f4a70d3..cf23fb18 100644 --- a/TerminalDocs/custom-terminal-gallery/custom-schemes.md +++ b/TerminalDocs/custom-terminal-gallery/custom-schemes.md @@ -1,5 +1,5 @@ --- -title: Windows terminal Custom Color Schemes guide +title: Windows Terminal Custom Color Schemes guide description: Some sample configurations for Windows Terminal. author: cinnamon-msft ms.author: cinnamon diff --git a/TerminalDocs/customize-settings/profile-appearance.md b/TerminalDocs/customize-settings/profile-appearance.md index a4c702bb..e4ef3b43 100644 --- a/TerminalDocs/customize-settings/profile-appearance.md +++ b/TerminalDocs/customize-settings/profile-appearance.md @@ -123,7 +123,7 @@ This sets the percentage height of the cursor starting from the bottom. This wil **Necessity:** Optional -**Accepts:** Integer from 25-100 +**Accepts:** Integer from 1-100
diff --git a/TerminalDocs/get-started.md b/TerminalDocs/get-started.md index b9b2e9f6..98dbf523 100644 --- a/TerminalDocs/get-started.md +++ b/TerminalDocs/get-started.md @@ -10,21 +10,50 @@ ms.localizationpriority: high # Install and set up Windows Terminal -## Installation +## Install -You can install Windows Terminal from the [Microsoft Store](https://aka.ms/terminal). +> [!div class="nextstepaction"] +> [Install Windows Terminal](https://aka.ms/terminal) -If you don't have access to the Microsoft Store, the builds are published on the [GitHub releases page](https://github.com/microsoft/terminal/releases). If you install from GitHub, the terminal will not automatically update with new versions. +To try the latest preview features, you may also want to [install Windows Terminal Preview](https://www.microsoft.com/p/windows-terminal-preview/9n8g5rfz9xk3#activetab=pivot:overviewtab). -## First run +> [!NOTE] +> If you don't have access to the Microsoft Store, the builds are published on the **[GitHub releases page](https://github.com/microsoft/terminal/releases)**. If you install from GitHub, Windows Terminal will not automatically update with new versions. For additional installation options using a package manager (winget, chocolatey, scoop), see the **[Windows Terminal product repo](https://github.com/microsoft/terminal#other-install-methods)**. -After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab. +## Set your default terminal application ([Preview](https://aka.ms/terminal-preview)) -![Windows Terminal first run](./images/first-run.png) +To open any command line application with Windows Terminal, set it as your default terminal application. -### Dynamic profiles +1. Open Windows Terminal and go to the **Settings** UI window. +2. Select **Startup** and choose "Windows Terminal" as the **Default terminal application** setting. -The terminal will automatically create profiles for you if you have WSL distros or multiple versions of PowerShell installed. Learn more about dynamic profiles on the [Dynamic profiles page](./dynamic-profiles.md). +![Screenshot of Windows Terminal Startup default in Settings UI](./images/settings-default-shell.png) + +> [!IMPORTANT] +> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview). + +## Set your default terminal profile + +After installation, when you open Windows Terminal, it will start with the [PowerShell](/powershell) command line as the default profile in the open tab. + +To change the default profile: + +1. Open Windows Terminal and go to the **Settings** UI window. +2. Select **Startup** and choose the **Default profile** that you prefer. + +You can also [set your default profile in the Settings.json file](./customize-settings/startup.md#default-profile) associated with Windows Terminal if you prefer. + +![Screenshot of Windows Terminal Settings default profile](./images/settings-default-profile.png) + +## Add new profiles + +Windows Terminal will automatically create profiles for you if you have WSL distributions or multiple versions of PowerShell installed. + +Your command line profiles will be listed in the Settings UI, in addition to the option to **+ Add new** profiles. + +Learn more about dynamic profiles on the [Dynamic profiles page](./dynamic-profiles.md). + +![Screenshot of Windows Terminal Settings list of profiles](./images/settings-dynamic-profiles.png) ## Open a new tab diff --git a/TerminalDocs/images/settings-default-profile.png b/TerminalDocs/images/settings-default-profile.png new file mode 100644 index 00000000..7a9d1e05 Binary files /dev/null and b/TerminalDocs/images/settings-default-profile.png differ diff --git a/TerminalDocs/images/settings-default-shell.png b/TerminalDocs/images/settings-default-shell.png new file mode 100644 index 00000000..6ce698b2 Binary files /dev/null and b/TerminalDocs/images/settings-default-shell.png differ diff --git a/TerminalDocs/images/settings-dynamic-profiles.png b/TerminalDocs/images/settings-dynamic-profiles.png new file mode 100644 index 00000000..59066928 Binary files /dev/null and b/TerminalDocs/images/settings-dynamic-profiles.png differ diff --git a/TerminalDocs/tutorials/powerline-setup.md b/TerminalDocs/tutorials/powerline-setup.md index e266ce86..d065e2f6 100644 --- a/TerminalDocs/tutorials/powerline-setup.md +++ b/TerminalDocs/tutorials/powerline-setup.md @@ -109,8 +109,7 @@ wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/posh- chmod +x /usr/local/bin/oh-my-posh ``` -The second step is optional. Oh-my-posh can use the same theme config regardless of the shell or evironment, so if you're already using -it on Windows Powershell for example, you can reuse that theme configuration rather than download the themes. +The second step is optional. Oh-my-posh can use the same theme config regardless of the shell or environment, so if you're already using it on Windows Powershell for example, you can reuse that theme configuration rather than download the themes. If you plan to use it within Ubuntu WSL only, fetch the [themes](https://ohmyposh.dev/docs/themes) so you can get started right away: ```bash