Terminal.Gui 2.0.0-develop.4477

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
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.4477
                    


                    

                
NuGet\Install-Package Terminal.Gui -Version 2.0.0-develop.4477
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.4477" />
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.4477" />
                    


                            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.4477
                    


                    

                
#r "nuget: Terminal.Gui, 2.0.0-develop.4477"
#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. 
#addin nuget:?package=Terminal.Gui&version=2.0.0-develop.4477&prerelease
                    


                            Install Terminal.Gui as a Cake Addin
                        

                    

                
#tool nuget:?package=Terminal.Gui&version=2.0.0-develop.4477&prerelease
                    


                            Install Terminal.Gui as a Cake Tool

.NET Core Version Code Coverage Downloads License Bugs

Terminal.Gui

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 prealpha release of Terminal.Gui v2 is NuGet Version

⚠️ Note:
Developers starting new TUI projects are encouraged to target v2. 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.GuiV2Docs.

Getting Started

API Reference

For detailed API documentation, see the API Reference.

Installing

Use NuGet to install the Terminal.Gui NuGet package:

v2 Pre-Alpha

(Infrequently updated, but stable enough for production use)

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

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

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

Contributing

See CONTRIBUTING.md.

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 (25)

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 (17)

Showing the top 17 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
Decimation/SmartImage
Reverse image search tool (SauceNao, IQDB, Ascii2D, trace.moe, and more)
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
Texnomic/SecureDNS
Secure, Modern, Fully-Featured, All-In-One Cross-Architecture & Cross-Platform DNS Server Using .NET 8.0
PKISharp/ACMESharpCore
An ACME v2 client library for .NET Standard (Let's Encrypt)
YSGStudyHards/DotNetExercises
⚔【DotNetGuide专栏C#/.NET/.NET Core编程技巧练习集】C#/.NET/.NET Core编程常用语法、算法、技巧、中间件、类库、工作业务实操练习集，配套详细的文章教程讲解，助你快速掌握C#/.NET/.NET Core中各种编程常用语法、算法、技巧、中间件、类库、工作业务实操等等。
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.
henrikstengaard/hstwb-installer
A set of scripts to automate installation of Amiga OS, Kickstart roms and packages to new or existing Amiga HDF files
Version Downloads Last updated
2.0.0-prealpha.1985 47 6/1/2025
2.0.0-prealpha.1981 35 6/1/2025
2.0.0-prealpha.1964 124 5/29/2025
2.0.0-prealpha.1961 105 5/29/2025
2.0.0-prealpha.1928 112 5/29/2025
2.0.0-develop.4478 0 6/3/2025
2.0.0-develop.4477 36 6/1/2025
2.0.0-develop.4476 37 6/1/2025
2.0.0-develop.4475 26 6/1/2025
2.0.0-develop.4432 40 5/31/2025
2.0.0-develop.4431 108 5/29/2025
2.0.0-develop.4430 105 5/29/2025
1.19.0-develop.16 126 4/24/2025
1.19.0-develop.15 120 4/24/2025
1.18.1 2,910 4/24/2025
1.18.0 5,019 3/16/2025
1.17.1 57,571 7/11/2024
1.16.0 40,062 3/16/2024
1.15.1 41,242 1/22/2024
1.14.1 50,278 10/30/2023
1.13.4 1,358 7/19/2023
1.7.1 1,302 8/1/2022
1.6.3 1,063 5/27/2022
1.2.0 1,704 8/24/2021
1.1.0 709 5/16/2021

See: https://github.com/gui-cs/Terminal.Gui/releases