Terminal.Gui 2.0.0-develop.4403

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


                    

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


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


                    

                
#r "nuget: Terminal.Gui, 2.0.0-develop.4403"
#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.4403&prerelease
                    


                            Install Terminal.Gui as a Cake Addin
                        

                    

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


                            Install Terminal.Gui as a Cake Tool

Terminal.Gui .NET Core Version Code Coverage Downloads License Bugs

  • The current, stable, release of Terminal.Gui v1 is Version.
  • The current prealpha release of Terminal.Gui v2 can be found on Nuget.
  • 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.
  • v1 is in maintenance mode and we will only accept PRs for issues impacting existing functionality.

Terminal.Gui: A toolkit for building rich console apps for Windows, the Mac, and Linux/Unix.

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

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

Documentation

The above documentation matches the most recent Nuget release from the v2_develop branch. Get the v1 documentation here.

See the Terminal.Gui/README for an overview of how the library is structured.

Showcase & Examples

Terminal.Gui can be used with any .Net language to create feature rich and robust applications.
Showcase is a place where you can find all kind of projects from simple examples to advanced real world apps that fully utilize capabilities of the toolkit.
The team is looking forward to seeing new amazing projects made by the community to be added there!

Sample Usage in C#

The following example shows a basic Terminal.Gui application in C#:
Example (source)

When run the application looks as follows:

Simple Usage app

Sample usage in F#

F# examples are located here

Installing

Use NuGet to install the Terminal.Gui NuGet package: https://www.nuget.org/packages/Terminal.Gui

Installation in .NET Core Projects

To install Terminal.Gui into a .NET Core project, use the dotnet CLI tool with this command.

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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (24)

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
gui-cs/Terminal.Gui
Cross Platform Terminal UI toolkit for .NET
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)
ironmansoftware/psedit
A terminal-based editor for PowerShell
YSGStudyHards/DotNetExercises
⚔【DotNetGuide专栏C#/.NET/.NET Core编程技巧练习集】C#/.NET/.NET Core编程常用语法、算法、技巧、中间件、类库、工作业务实操练习集，配套详细的文章教程讲解，助你快速掌握C#/.NET/.NET Core中各种编程常用语法、算法、技巧、中间件、类库、工作业务实操等等。
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.
Version Downloads Last updated
2.0.0-prealpha.1895 476 3/21/2025
2.0.0-develop.4406 49 4/5/2025
2.0.0-develop.4405 127 4/2/2025
2.0.0-develop.4404 109 3/31/2025
2.0.0-develop.4403 53 3/29/2025
2.0.0-develop.4402 49 3/29/2025
2.0.0-develop.4401 189 3/21/2025
1.18.0 2,341 3/16/2025
1.17.1 49,392 7/11/2024
1.16.0 37,369 3/16/2024
1.15.1 37,849 1/22/2024
1.14.1 46,196 10/30/2023
1.13.4 1,293 7/19/2023
1.7.1 1,265 8/1/2022
1.6.3 1,010 5/27/2022
1.2.0 1,628 8/24/2021
1.1.0 682 5/16/2021

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