README

!Windows Terminal project logos and branding image



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


  Table of Contents

- Installing and running Windows Terminal
  - [Microsoft Store \[Recommended\]](microsoft-store-recommended)
  - Other install methods
    - Via GitHub
    - Via Windows Package Manager CLI (aka winget)
    - Via Chocolatey (unofficial)
    - Via Scoop (unofficial)
- Installing Windows Terminal Canary
- Terminal \& Console Overview
  - Windows Terminal
  - The Windows Console Host
  - Shared Components
  - Creating the new Windows Terminal
- Resources
- FAQ
  - I built and ran the new Terminal, but it looks just like the old console
- Documentation
- Contributing
- Communicating with the Team
- Developer Guidance
- Prerequisites
- Building the Code
  - Building in PowerShell
  - Building in Cmd
- Running \& Debugging
  - Coding Guidance
- Code of Conduct





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:

 Windows Terminal Documentation
  (Repo: Contribute to the docs)
 Console API Documentation
 Cascadia Code Font

 Installing and running Windows Terminal

 [!NOTE]
 Windows Terminal requires Windows 10 2004 (build 19041) or later

 Microsoft Store [Recommended]

Install the [Windows Terminal from the Microsoft Store][store-install-link].
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

 Via GitHub

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:

powershell
 NOTE: If you are using PowerShell 7+, please run
 Import-Module Appx -UseWindowsPowerShell
 before using Add-AppxPackage.

Add-AppxPackage Microsoft.WindowsTerminal_.msixbundle


 [!NOTE]
 If you install Terminal manually:

  You may need to install the VC++ v14 Desktop Framework Package.
   This should only be necessary on older builds of Windows 10 and only if you get an error about missing framework packages.
  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:

powershell
winget install --id Microsoft.WindowsTerminal -e

Top issues

Discussions

Latest release

Terminal 1.25 is finally stable!

Here are the highlights:
 A new settings search experience! We have a lot of settings; hopefully this helps you find them.
 A rich "actions" editor that will let you better customize how you interact with Terminal.
 Support for the "Kitty" input protocol, for a highly opinionated way to distinguish keyboard keys and how they were pressed.
 Window persistence with _or without_ the scrollback history.
 Community translations into Ukrainian and Serbian (Cyrillic).
 The ability to configure how wide "ambiguous" Unicode characters are for improved compatibi