Install and set up Windows Terminal

Installation

You can install Windows Terminal from the Microsoft Store.

If you don’t have access to the Microsoft Store, the builds are published on the GitHub releases page. If you install from GitHub, the terminal will not automatically update with new versions.

First run

After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.

Dynamic profiles

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.

Open a new tab

You can open a new tab of the default profile by pressing Ctrl + Shift + T or by selecting the + (plus) button. To open a different profile, select the Л… (arrow) next to the + button to open the dropdown menu. From there, you can select which profile to open.

Invoke the command palette

You can invoke most features of Windows Terminal through the command palette. The default key combination to invoke it is Ctrl + Shift + P .

Open a new pane

You can run multiple shells side-by-side using panes. To open a pane, you can use Alt + Shift + + for a vertical pane or Alt + Shift + — for a horizontal one. You can also use Alt + Shift + D to open a duplicate pane of your focused profile. Learn more about panes on the Panes page.

Configuration

To customize the settings of your Windows Terminal, select Settings in the dropdown menu. This will open the settings.json file in your default text editor. (The default text editor is defined in your Windows settings.)

The terminal supports customization of global properties that affect the whole application, profile properties that affect the settings of each profile, and actions that allow you to interact with the terminal using your keyboard or the command palette.

You can also use the settings UI to configure your settings if you are using Windows Terminal Preview. You can learn how to open the settings UI on the Actions page.

Command line arguments

You can launch the terminal in a specific configuration using command line arguments. These arguments let you open the terminal with specific tabs and panes with custom profile settings. Learn more about command line arguments on the Command line arguments page.

Troubleshooting

If you encounter any difficulties using the terminal, reference the Troubleshooting page. If you find any bugs or have a feature request, you can select the feedback link in the About menu of the terminal to go to the GitHub page where you can file a new issue.

Установка и настройка Терминала Windows Install and set up Windows Terminal

Установка Installation

Терминал Windows можно установить из Microsoft Store. You can install Windows Terminal from the Microsoft Store.

Если у вас нет доступа к Microsoft Store, можно скачать сборки, опубликованные на странице выпусков GitHub. If you don’t have access to the Microsoft Store, the builds are published on the GitHub releases page. При установке из GitHub терминал не будет автоматически обновляться с установкой новых версий. If you install from GitHub, the terminal will not automatically update with new versions.

Первый запуск First run

После установки при открытии терминала он запустится с помощью PowerShell в качестве профиля по умолчанию в открытой вкладке. After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.

Динамические профили Dynamic profiles

Если у вас установлены дистрибутивы WSL или несколько версий PowerShell, терминал автоматически создаст профили. 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.

Открытие новой вкладки Open a new tab

Новую вкладку профиля по умолчанию можно открыть, нажав сочетание клавиш Ctrl+Shift+T или кнопку «+» (плюс). You can open a new tab of the default profile by pressing ctrl+shift+t or by selecting the + (plus) button. Открыть другой профиль можно с помощью раскрывающегося меню. Для этого щелкните «˅» (стрелка) рядом с кнопкой «+». To open a different profile, select the ˅ (arrow) next to the + button to open the dropdown menu. Из этого меню можно выбрать, какой профиль следует открыть. From there, you can select which profile to open.

Открытие новой панели Open a new pane

Вы можете параллельно запустить несколько оболочек с помощью панелей. You can run multiple shells side-by-side using panes. Чтобы открыть панель, нажмите сочетание клавиш ALT+SHIFT+D . To open a pane, you can use alt+shift+d . С помощью этого настраиваемого сочетания клавиш можно открыть еще одну панель выделенного профиля. This key binding will open a duplicate pane of your focused profile. Дополнительные сведения о панелях см. на этой странице. Learn more about panes on the Panes page.

Конфигурация Configuration

Чтобы выполнить настройку параметров Терминала Windows, в раскрывающемся меню выберите Параметры. To customize the settings of your Windows Terminal, select Settings in the dropdown menu. В текстовом редакторе по умолчанию откроется файл settings.json . This will open the settings.json file in your default text editor. (Текстовый редактор по умолчанию определяется в параметрах Windows.) (The default text editor is defined in your Windows settings.)

Терминал поддерживает настройку глобальных свойств, влияющих на все приложение, свойств профиля, влияющих на параметры каждого профиля, а также сочетания клавиш, позволяющих взаимодействовать с терминалом с помощью клавиатуры. The terminal supports customization of global properties that affect the whole application, profile properties that affect the settings of each profile, and key bindings that allow you to interact with the terminal using your keyboard.

Аргументы командной строки Command line arguments

Вы можете запустить терминал в определенной конфигурации с помощью аргументов командной строки. You can launch the terminal in a specific configuration using command-line arguments. С помощью этих аргументов можно открыть терминал с конкретными вкладками и панелями, применяя параметры настраиваемого профиля. These arguments let you open the terminal with specific tabs and panes with custom profile settings. Дополнительные сведения об аргументах командной строки см. на этой странице. Learn more about command-line arguments on the Command line arguments page.

Диагностика Troubleshooting

В случае возникновения каких-либо проблем при использовании терминала посетите страницу устранения неполадок. If you encounter any difficulties using the terminal, reference the Troubleshooting page. Если вы заметите какие-либо ошибки или захотите отправить запрос функции, щелкните в меню терминала О программе ссылку «Отзыв», чтобы перейти на страницу GitHub и сообщить об ошибке. If you find any bugs or have a feature request, you can select the feedback link in the About menu of the terminal to go to the GitHub page where you can file a new issue.

Как установить Windows Terminal на Windows 10

Windows Terminal – это новое приложение от Microsoft с интерфейсом командной строки, которое предназначено для работы с командной строкой (CMD), сценариями PowerShell, подключениями SSH и системой WSL. С помощью данного приложения можно запускать сразу несколько разных приложений терминала в разных вкладках и работать с ними параллельно.

На данный момент приложение Windows Terminal находится на стадии разработки и не включено в состав Windows 10, но при желании его можно установить самостоятельно. В данной инструкции мы рассмотрим именно этот вопрос, здесь вы узнаете сразу три способа, как установить Windows Terminal на Windows 10.

Системные требования

Чтобы установить Windows Terminal (любым из описанных ниже способов) ваша система должна соответствовать минимальным системным требованиям. Во-первых, для работы данного приложения требуется операционная система Windows 10 (старые ОС не поддерживаются). А во-вторых, она должна быть обновлена до версии 18362 .

Для того чтобы узнать, какая версия Windows 10 у вас установлена нажмите комбинацию Win-R и выполните команду « winver ».

В открывшемся окне будет указана версия сборки ОС. Если ваша версия 18362 или выше, то можно приступать к установке Windows Terminal.

Установка через Microsoft Store

На данный момент Windows Terminal уже можно установить через магазин приложений Microsoft Store. Чтобы запустить данный магазин откройте меню « Пуск », введите в поиск слово « store » и запустите найденную программу.

После запуска Microsoft Store, в нем нужно найти приложение Windows Terminal (Preview). Для этого можно воспользоваться поиском по магазину приложений. Введите в поисковую строку слово «terminal» и нажмите на верхнее приложение.

Если с поиском возникают трудности, то можете воспользоваться этой ссылкой. Кликнув по ссылке, вы попадете на веб-версию магазина Microsoft Store. Здесь нужно будет нажать на кнопку « Получить » и подтвердить переход в приложение.

Так или иначе, вы попадете в Microsoft Store на страницу приложения Windows Terminal (Preview). Здесь нужно нажать на кнопку « Install » и дождаться завершения установки приложения.

После установки можно сразу начинать пользоваться Windows Terminal, перезагрузка компьютера не требуется. Чтобы запустить приложение нужно нажать на кнопку « Launch » в Microsoft Store или воспользоваться поиском в меню « Пуск ».

Установка с помощью Chocolatey

Также вы можете установить Windows Terminal с помощью Chocolatey. Программа Chocolatey – это менеджер пакетов в стиле Linux для операционной системы Windows.

Для того чтобы установить Windows Terminal с помощью Chocolatey нужно сначала установить непосредственно сам Chocolatey. Для этого запустите PowerShell с правами администратора и выполните указанную ниже команду.

После установки перезапускаем командную строку (с правами администратора) и вводим команду « choco ». Если все нормально, то вы должны получить сообщение как на скриншоте внизу.

После установки Chocolatey можно запускать установку терминала. Для этого в PowerShell (с правами администратора) нужно выполнить следующую команду:

В процессе установки нужно несколько раз нажать клавишу « Y » для подтверждения установки требуемых компонентов. После завершения работы команды Windows Terminal будет установлен.

Сборка из исходников

Некоторое время этот способ был единственным вариантом получить приложение Windows Terminal, но сейчас он уже не так актуален, поскольку приложение стало доступно в Microsoft Store.

Для того чтобы собрать Windows Terminal из исходников вам необходимо выполнить следующие действия:

• Установить Visual Studio 2017 или Visual Studio 2019 с SDK 1903, а также следующие пакеты:
  • Desktop Development with C++
  • Universal Windows Platform Development.
  • v141 Toolset and Visual C++ ATL for x86 and x64. (Visual Studio 2019 only).
• Включить режим разработчика в Windows 10.
• Скачать и распаковать исходники из официального репозитория на GitHub.

После этого нужно открыть распакованный проект в Visual Studio IDE, выбрать тип релиза « Release » и скомпилировать исполняемый файл.

Windows terminal offline installer

Welcome to the Windows Terminal, Console and Command-Line repo

This repository contains the source code for:

• Windows Terminal
• Windows Terminal Preview
• The Windows console host ( conhost.exe )
• Components shared between the two projects
• ColorTool
• Sample projects that show how to consume the Windows Console APIs

Related repositories include:

Installing and running Windows Terminal

🔴 Note: Windows Terminal requires Windows 10 1903 (build 18362) or later

Microsoft Store [Recommended]

Install the Windows Terminal from the Microsoft Store. This allows you to always be on the latest version when we release new builds with automatic upgrades.

This is our preferred method.

Other install methods

For users who are unable to install Windows Terminal from the Microsoft Store, released builds can be manually downloaded from this repository’s Releases page.

Download the Microsoft.WindowsTerminal_ .msixbundle file from the Assets section. To install the app, you can simply double-click on the .msixbundle file, and the app installer should automatically run. If that fails for any reason, you can try the following command at a PowerShell prompt:

🔴 Note: If you install Terminal manually:

• Terminal will not auto-update when new builds are released so you will need to regularly install the latest Terminal release to receive all the latest fixes and improvements!

Via Windows Package Manager CLI (aka winget)

winget users can download and install the latest Terminal release by installing the Microsoft.WindowsTerminal package:

Via Chocolatey (unofficial)

Chocolatey users can download and install the latest Terminal release by installing the microsoft-windows-terminal package:

To upgrade Windows Terminal using Chocolatey, run the following:

If you have any issues when installing/upgrading the package please go to the Windows Terminal package page and follow the Chocolatey triage process

Via Scoop (unofficial)

Scoop users can download and install the latest Terminal release by installing the windows-terminal package:

To update Windows Terminal using Scoop, run the following:

If you have any issues when installing/updating the package, please search for or report the same on the issues page of Scoop Extras bucket repository.

Windows Terminal 2.0 Roadmap

The plan for delivering Windows Terminal 2.0 is described here and will be updated as the project proceeds.

Project Build Status

Project	Build Status
Terminal
ColorTool

Terminal & Console Overview

Please take a few minutes to review the overview below before diving into the code:

Windows Terminal is a new, modern, feature-rich, productive terminal application for command-line users. It includes many of the features most frequently requested by the Windows command-line community including support for tabs, rich text, globalization, configurability, theming & styling, and more.

The Terminal will also need to meet our goals and measures to ensure it remains fast and efficient, and doesn’t consume vast amounts of memory or power.

The Windows Console Host

The Windows Console host, conhost.exe , is Windows’ original command-line user experience. It also hosts Windows’ command-line infrastructure and the Windows Console API server, input engine, rendering engine, user preferences, etc. The console host code in this repository is the actual source from which the conhost.exe in Windows itself is built.

Since taking ownership of the Windows command-line in 2014, the team added several new features to the Console, including background transparency, line-based selection, support for ANSI / Virtual Terminal sequences, 24-bit color, a Pseudoconsole («ConPTY»), and more.

However, because Windows Console’s primary goal is to maintain backward compatibility, we have been unable to add many of the features the community (and the team) have been wanting for the last several years including tabs, unicode text, and emoji.

These limitations led us to create the new Windows Terminal.

You can read more about the evolution of the command-line in general, and the Windows command-line specifically in this accompanying series of blog posts on the Command-Line team’s blog.

While overhauling Windows Console, we modernized its codebase considerably, cleanly separating logical entities into modules and classes, introduced some key extensibility points, replaced several old, home-grown collections and containers with safer, more efficient STL containers, and made the code simpler and safer by using Microsoft’s Windows Implementation Libraries — WIL.

This overhaul resulted in several of Console’s key components being available for re-use in any terminal implementation on Windows. These components include a new DirectWrite-based text layout and rendering engine, a text buffer capable of storing both UTF-16 and UTF-8, a VT parser/emitter, and more.

Creating the new Windows Terminal

When we started planning the new Windows Terminal application, we explored and evaluated several approaches and technology stacks. We ultimately decided that our goals would be best met by continuing our investment in our C++ codebase, which would allow us to reuse several of the aforementioned modernized components in both the existing Console and the new Terminal. Further, we realized that this would allow us to build much of the Terminal’s core itself as a reusable UI control that others can incorporate into their own applications.

The result of this work is contained within this repo and delivered as the Windows Terminal application you can download from the Microsoft Store, or directly from this repo’s releases.

For more information about Windows Terminal, you may find some of these resources useful and interesting:

I built and ran the new Terminal, but it looks just like the old console

Cause: You’re launching the incorrect solution in Visual Studio.

Solution: Make sure you’re building & deploying the CascadiaPackage project in Visual Studio.

⚠ Note: OpenConsole.exe is just a locally-built conhost.exe , the classic Windows Console that hosts Windows’ command-line infrastructure. OpenConsole is used by Windows Terminal to connect to and communicate with command-line applications (via ConPty).

All project documentation is located at aka.ms/terminal-docs. If you would like to contribute to the documentation, please submit a pull request on the Windows Terminal Documentation repo.

We are excited to work alongside you, our amazing community, to build and enhance Windows Terminal!

BEFORE you start work on a feature/fix, please read & follow our Contributor’s Guide to help avoid any wasted or duplicate effort.

Communicating with the Team

The easiest way to communicate with the team is via GitHub issues.

Please file new issues, feature requests and suggestions, but DO search for similar open/closed pre-existing issues before creating a new issue.

If you would like to ask a question that you feel doesn’t warrant an issue (yet), please reach out to us via Twitter:

• Kayla Cinnamon, Program Manager: @cinnamon_msft
• Dustin Howett, Engineering Lead: @dhowett
• Michael Niksa, Senior Developer: @michaelniksa
• Mike Griese, Developer: @zadjii
• Carlos Zamora, Developer: @cazamor_msft
• Leon Liang, Developer: @leonmsft
• Pankaj Bhojwani, Developer

• You must be running Windows 1903 (build >= 10.0.18362.0) or later to run Windows Terminal
• You must enable Developer Mode in the Windows Settings app to locally install and run Windows Terminal
• You must have the Windows 10 1903 SDK installed
• You must have at least VS 2019 installed
• You must install the following Workloads via the VS Installer. Note: Opening the solution in VS 2019 will prompt you to install missing components automatically:
  • Desktop Development with C++
  • Universal Windows Platform Development
  • The following Individual Components
    • C++ (v142) Universal Windows Platform Tools

Building the Code

This repository uses git submodules for some of its dependencies. To make sure submodules are restored or updated, be sure to run the following prior to building:

OpenConsole.sln may be built from within Visual Studio or from the command-line using a set of convenience scripts & tools in the /tools directory:

Building in PowerShell

Building in Cmd

To debug the Windows Terminal in VS, right click on CascadiaPackage (in the Solution Explorer) and go to properties. In the Debug menu, change «Application process» and «Background task process» to «Native Only».

You should then be able to build & debug the Terminal project by hitting F5 .

👉 You will not be able to launch the Terminal directly by running the WindowsTerminal.exe. For more details on why, see #926, #4043

Please review these brief docs below about our coding practices.

👉 If you find something missing from these docs, feel free to contribute to any of our documentation files anywhere in the repository (or write some new ones!)

This is a work in progress as we learn what we’ll need to provide people in order to be effective contributors to our project.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

About

The new Windows Terminal and the original Windows console host, all in the same place!