Terminal.Gui 2.0.0-develop.4650

This is a prerelease version of Terminal.Gui.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Terminal.Gui --version 2.0.0-develop.4650
                    
NuGet\Install-Package Terminal.Gui -Version 2.0.0-develop.4650
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Terminal.Gui" Version="2.0.0-develop.4650" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Terminal.Gui" Version="2.0.0-develop.4650" />
                    
Directory.Packages.props
<PackageReference Include="Terminal.Gui" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Terminal.Gui --version 2.0.0-develop.4650
                    
#r "nuget: Terminal.Gui, 2.0.0-develop.4650"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Terminal.Gui@2.0.0-develop.4650
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Terminal.Gui&version=2.0.0-develop.4650&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Terminal.Gui&version=2.0.0-develop.4650&prerelease
                    
Install as a Cake Tool

Version codecov Downloads License Bugs

Terminal.Gui v2

The premier toolkit for building rich console apps for Windows, the Mac, and Linux/Unix.

logo

  • The current, stable, release of Terminal.Gui v1 is Version.

⚠️ Note:
v1 is in maintenance mode and we will only accept PRs for issues impacting existing functionality.

  • The current Alpha release of Terminal.Gui v2 is NuGet Version

⚠️ Note:
Developers starting new TUI projects are encouraged to target v2 Alpha. The API is significantly changed, and significantly improved. There will be breaking changes in the API before Beta, but the core API is stable.

Sample app

Quick Start

Paste these commands into your favorite terminal on Windows, Mac, or Linux. This will install the Terminal.Gui.Templates, create a new "Hello World" TUI app, and run it.

(Press CTRL-Q to exit the app)

dotnet new --install Terminal.Gui.templates
dotnet new tui -n myproj
cd myproj
dotnet run

To run the UICatalog demo app that shows all the controls and features of the toolkit, use the following command:

dotnet run --project Examples/UICatalog/UICatalog.csproj

There is also a visual designer (uses Terminal.Gui itself).

Documentation

The full developer documentation for Terminal.Gui is available at gui-cs.github.io/Terminal.Gui.

Getting Started

API Reference

For detailed API documentation, see the API Reference.

Installing

Use NuGet to install the Terminal.Gui NuGet package:

v2 Alpha

(Infrequently updated, but stable enough for production use)

dotnet add package Terminal.Gui --version "2.0.0-alpha.*"

v2 Develop

(Frequently updated, but may have breaking changes)

dotnet add package Terminal.Gui --version "2.0.0-develop.*"

Legacy v1

dotnet add package Terminal.Gui --version "1.*

Or, you can use the Terminal.Gui.Templates.

Contributing

See CONTRIBUTING.md for complete contribution guidelines.

Debates on architecture and design can be found in Issues tagged with design.

History

See gui-cs for how this project came to be.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (26)

Showing the top 5 NuGet packages that depend on Terminal.Gui:

Package Downloads
HIC.RDMP.Plugin

Core package for plugin development

Carbon.Kit

Provides interfaces, abstractions and common functions which is the essence of Carbon Kit.

FluiTec.AppFx.Console

Package Description

M5x.TermUi

Package Description

Terminal.Gui.Elmish

An elmish wrapper around Miguel de Icaza's 'Gui.cs' https://github.com/migueldeicaza/gui.cs including F# Feliz-like like view DSL.

GitHub repositories (18)

Showing the top 18 popular GitHub repositories that depend on Terminal.Gui:

Repository Stars
awaescher/RepoZ
👨‍💻 A zero-conf git repository hub for Windows and macOS with Windows Explorer- & CLI-enhancements
PowerShell/ConsoleGuiTools
Modules that mix PowerShell and GUIs/CUIs!
paillave/Etl.Net
Mass processing data with a complete ETL for .net developers
bjorkstromm/depends
Tool for generating dependency trees for .NET projects
gui-cs/TerminalGuiDesigner
Forms Designer for Terminal.Gui (aka gui.cs)
NicolasConstant/BirdsiteLive
An ethical bridge from Twitter
CCob/Volumiser
YSGStudyHards/DotNetExercises
⚔【DotNetGuide专栏C#/.NET/.NET Core编程技巧练习集】C#/.NET/.NET Core编程常用语法、算法、技巧、中间件、类库、工作业务实操练习集,配套详细的文章教程和代码示例,助力快速掌握C#/.NET/.NET Core中各种编程常用语法、算法、技巧、中间件、类库、工作业务实操等等。
Texnomic/SecureDNS
Secure, Modern, Fully-Featured, All-In-One Cross-Architecture & Cross-Platform DNS Server Using .NET 10
PKISharp/ACMESharpCore
An ACME v2 client library for .NET Standard (Let's Encrypt)
ironmansoftware/psedit
A terminal-based editor for PowerShell
reactiveui/ReactiveMvvm
Cross-platform ReactiveUI sample app built for a talk at MSK .NET conf.
migueldeicaza/XtermSharp
XTerm emulator as a .NET library
mbbsemu/MBBSEmu
The MajorBBS Emulation Project is an Open Source, Cross-Platform emulator for easily running The MajorBBS & Worldgroup Modules
Draco-lang/Compiler
The compiler repository for the Draco programming language.
timkicker/podliner
Podcasts in any terminal. Fast, clean, offline.
henrikstengaard/hstwb-installer
A set of scripts to automate installation of Amiga OS, Kickstart roms and packages to new or existing Amiga HDF files
NethermindEth/dotnet-libp2p
A libp2p implementation for .NET in C#.
Version Downloads Last Updated
2.0.0-develop.4747 0 1/2/2026
2.0.0-develop.4746 212 12/21/2025
2.0.0-develop.4745 111 12/21/2025
2.0.0-develop.4744 119 12/20/2025
2.0.0-develop.4743 248 12/18/2025
2.0.0-develop.4742 225 12/18/2025
2.0.0-develop.4741 221 12/18/2025
2.0.0-develop.4740 221 12/18/2025
2.0.0-develop.4739 226 12/17/2025
2.0.0-develop.4738 225 12/17/2025
2.0.0-develop.4737 284 12/17/2025
2.0.0-develop.4736 217 12/17/2025
2.0.0-develop.4731 224 12/16/2025
2.0.0-develop.4730 236 12/16/2025
2.0.0-develop.4729 202 12/15/2025
2.0.0-develop.4728 177 12/15/2025
2.0.0-develop.4727 133 12/13/2025
2.0.0-develop.4726 78 12/12/2025
2.0.0-develop.4725 457 12/9/2025
2.0.0-develop.4724 391 12/9/2025
2.0.0-develop.4723 393 12/9/2025
2.0.0-develop.4722 375 12/8/2025
2.0.0-develop.4721 373 12/8/2025
2.0.0-develop.4720 274 12/7/2025
2.0.0-develop.4719 259 12/7/2025
2.0.0-develop.4718 188 12/6/2025
2.0.0-develop.4717 76 12/6/2025
2.0.0-develop.4716 80 12/6/2025
2.0.0-develop.4715 84 12/6/2025
2.0.0-develop.4714 122 12/6/2025
2.0.0-develop.4713 172 12/5/2025
2.0.0-develop.4670 150 12/5/2025
2.0.0-develop.4669 145 12/5/2025
2.0.0-develop.4668 148 12/5/2025
2.0.0-develop.4667 149 12/4/2025
2.0.0-develop.4655 178 12/3/2025
2.0.0-develop.4654 148 12/3/2025
2.0.0-develop.4653 636 12/3/2025
2.0.0-develop.4652 636 12/1/2025
2.0.0-develop.4650 632 12/1/2025
2.0.0-develop.4639 458 11/20/2025
2.0.0-develop.4638 361 11/20/2025
2.0.0-develop.4637 379 11/19/2025
2.0.0-develop.4636 498 11/12/2025
2.0.0-alpha.3931 75 12/13/2025
2.0.0-alpha.3865 640 12/1/2025
2.0.0-alpha.3845 234 11/14/2025
1.20.0-develop.4 328 6/12/2025
1.19.0 30,072 6/12/2025
1.18.1 10,434 4/24/2025
1.18.0 6,946 3/16/2025
1.17.1 94,424 7/11/2024
1.16.0 50,544 3/16/2024
1.15.1 47,100 1/22/2024
1.14.1 64,536 10/30/2023
1.13.4 1,718 7/19/2023
1.7.1 1,639 8/1/2022
1.6.3 1,379 5/27/2022
1.2.0 1,968 8/24/2021
1.1.0 887 5/16/2021