Sen descrición

Tig dfb71c0bcd Merge branch 'v2_develop' into v2_3841-ConfigManager hai 9 meses
.devcontainer 651ee21ba5 Fixes #2323. The devcontainer.json settings isn't work with the current develop branch. %!s(int64=2) %!d(string=hai) anos
.github 9cb985de62 Update publish.yml hai 10 meses
CommunityToolkitExample 563d58a380 Code cleanup and refactor hai 10 meses
Example d8446fbaf1 hacked CM to special case Key hai 9 meses
FSharpExample 43994047ab fix the build issue of F# example hai 10 meses
NativeAot 8f1954f16c Fixes #3790. Can't build v2_develop RELEASE - "The local source 'C:\Users\Tig\s\gui-cs\Terminal.Gui\local_packages' doesn't exist." (#3794) hai 10 meses
ReactiveExample 78d0a8fc3b Accepted->Accepting hai 10 meses
Scripts 6b72b3f56b Remove PowerShell module for analyzers hai 1 ano
SelfContained 8f1954f16c Fixes #3790. Can't build v2_develop RELEASE - "The local source 'C:\Users\Tig\s\gui-cs\Terminal.Gui\local_packages' doesn't exist." (#3794) hai 10 meses
Terminal.Gui dfb71c0bcd Merge branch 'v2_develop' into v2_3841-ConfigManager hai 9 meses
UICatalog bae10e59ae New sample.gif hai 9 meses
UnitTests dfb71c0bcd Merge branch 'v2_develop' into v2_3841-ConfigManager hai 9 meses
docfx bae10e59ae New sample.gif hai 9 meses
local_packages 17e3fe8c5f Non-rectangular clip reigion support basically works hai 10 meses
.dockerignore 8ab759b30f Fixes #415 v2. Colors: OpenSUSE - The native method "COLOR_PAIRS" does not exist %!s(int64=2) %!d(string=hai) anos
.editorconfig c94c0567dd Fixes #3240: editorconfig and project documentation sync with reformatting (#3241) hai 1 ano
.filenesting.json 76d48f1fe8 Add solution default file nesting rules hai 1 ano
.gitattributes 4522097c02 Forces the height of the TextField to 1 which is just the valid height instead of driver rows value. (#400) %!s(int64=5) %!d(string=hai) anos
.gitignore 8f1954f16c Fixes #3790. Can't build v2_develop RELEASE - "The local source 'C:\Users\Tig\s\gui-cs\Terminal.Gui\local_packages' doesn't exist." (#3794) hai 10 meses
.vsconfig 1a68656d66 Add .vsconfig hai 1 ano
CODE_OF_CONDUCT.md 6144c9da66 added contribution guidelines, project layout docs, etc... %!s(int64=5) %!d(string=hai) anos
CONTRIBUTING.md d28e352c0a Addressed feedback #2 hai 1 ano
GitVersion.yml 1b973eed5a Trying to fix publish issue hai 1 ano
LICENSE 38af4cfcb8 Add %!s(int64=7) %!d(string=hai) anos
NoSamples.slnf b667c3de98 Remove analyzer projects from solution and project references hai 1 ano
README.md 27e6a61fc6 new banner hai 9 meses
Release.ps1 d71fa11a2b Fixed README, Showcase, and images hai 1 ano
Release.slnf b667c3de98 Remove analyzer projects from solution and project references hai 1 ano
Showcase.md d71fa11a2b Fixed README, Showcase, and images hai 1 ano
Terminal.sln 63e75b7413 Fixes #3109. AOT support with .Net 8. (#3638) hai 1 ano
Terminal.sln.DotSettings 95f21c383e LineCanvas code cleanup and API docs hai 9 meses
Terminal.sln.ToDo.DotSettings 3f29a96b33 Split out the todo list items and unify their definitions hai 1 ano
bench.json ce900ada49 Benchmark cleanup hai 10 meses
example_config.json dd88c392dd Added example user config.json hai 11 meses
global.json dcb3b359ad Fixes #2926 - Refactor KeyEvent and KeyEventEventArgs to simplify (#2927) hai 1 ano
nuget.config 9c6a3058d4 Fixes #3784. SelfContained and NativeAot projects should use the local package in the release mode. (#3785) hai 10 meses
pull_request_template.md b84862d0bd Fixes #3172. `Application.ResetState` wasn't resetting all it should (#3173) hai 1 ano
testenvironments.json 8ea6b105fc Fixes #2923. Ensures only clear Instances if they really was disposed. (#2924) hai 1 ano

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

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#:

[!code-csharp[](./Example/Example.cs)]

When run the application looks as follows:

Simple Usage app

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.