暂无描述

tznind 29355c8b63 Add automation test for selecting a submenu item 5 月之前
.devcontainer 651ee21ba5 Fixes #2323. The devcontainer.json settings isn't work with the current develop branch. 2 年之前
.github 73e230b877 upgraded to gitversion 6 5 月之前
Benchmarks cf2645fa04 StringExtensions.ToString(IEnumerable<Rune>) use rented array as alternative buffer 5 月之前
CommunityToolkitExample b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
DemoFiles b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
Example b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
FSharpExample 43994047ab fix the build issue of F# example 10 月之前
NativeAot b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
ReactiveExample af633fc4fc Fixes #3976. SixLabors.ImageSharp nuget package is reporting as vulnerable (#3977) 5 月之前
Scripts fe18c81dc9 Fixed gitversion 5 月之前
SelfContained b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
Terminal.Gui 79f289ce8f Rename to TerminalGuiFluentTesting 5 月之前
TerminalGuiFluentTesting 29355c8b63 Add automation test for selecting a submenu item 5 月之前
Tests 29355c8b63 Add automation test for selecting a submenu item 5 月之前
UICatalog ce7fc04100 Fixes #3984 - `Margin` w/out shadow should not force draw (#3985) 5 月之前
docfx acb5979e6c Cleans up/Refactors `View.Subviews` (#3962) 5 月之前
local_packages acb5979e6c Cleans up/Refactors `View.Subviews` (#3962) 5 月之前
.dockerignore 8ab759b30f Fixes #415 v2. Colors: OpenSUSE - The native method "COLOR_PAIRS" does not exist 2 年之前
.editorconfig c94c0567dd Fixes #3240: editorconfig and project documentation sync with reformatting (#3241) 1 年之前
.filenesting.json 76d48f1fe8 Add solution default file nesting rules 1 年之前
.gitattributes 98f70b2632 Adds `ViewportSettings.Transparent` (#3886) 6 月之前
.gitignore 5984a3c564 Fixes #3941 - v2win/v2net: UICatalog crash - Fixes warnings (#3946) 5 月之前
.vsconfig 1a68656d66 Add .vsconfig 1 年之前
CODE_OF_CONDUCT.md 6144c9da66 added contribution guidelines, project layout docs, etc... 5 年之前
CONTRIBUTING.md d28e352c0a Addressed feedback #2 1 年之前
Directory.Build.props b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
Directory.Packages.props 323c624046 WIP: Add fluent assertions and prototype the kind of things that should be possible 5 月之前
GitVersion.yml fe18c81dc9 Fixed gitversion 5 月之前
LICENSE 38af4cfcb8 Add 7 年之前
NoSamples.slnf b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
README.md dc004c4923 (Minor fix) Fix the link text, refer to the F# example too (#3901) 6 月之前
Release.slnf b0f32811eb Fixes #3930 - Splits tests to `Tests/UnitTests`, `Tests/IntegrationTests`, `Tests/StressTests` (#3954) 5 月之前
Showcase.md dd32717f78 Fix typo 9 月之前
Terminal.sln 1e40ad3bc9 Add csproj to sln 5 月之前
Terminal.sln.DotSettings acb5979e6c Cleans up/Refactors `View.Subviews` (#3962) 5 月之前
Terminal.sln.ToDo.DotSettings 3f29a96b33 Split out the todo list items and unify their definitions 1 年之前
global.json dcb3b359ad Fixes #2926 - Refactor KeyEvent and KeyEventEventArgs to simplify (#2927) 1 年之前
nuget.config 9c6a3058d4 Fixes #3784. SelfContained and NativeAot projects should use the local package in the release mode. (#3785) 10 月之前
pull_request_template.md b84862d0bd Fixes #3172. `Application.ResetState` wasn't resetting all it should (#3173) 1 年之前
testenvironments.json 8ea6b105fc Fixes #2923. Ensures only clear Instances if they really was disposed. (#2924) 1 年之前

README.md

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.