No Description

Brandon Thetford 3f29a96b33 Split out the todo list items and unify their definitions 1 year ago
.devcontainer 651ee21ba5 Fixes #2323. The devcontainer.json settings isn't work with the current develop branch. 2 years ago
.github aa78014215 Fixes #3470 try 2 1 year ago
Analyzers 428b436ce4 Suppress a warning caused by code from a polyfill. 1 year ago
CommunityToolkitExample 6a89686bfa Merge branch 'v2_communitytoolkit' of https://github.com/johnmbaughman/Terminal.Gui into v2_communitytoolkit 1 year ago
Example 561d671746 Removed un-needed and un-used RequestStop override from Scenario 1 year ago
FSharpExample 2971fc9134 Fixes #769. Include PDB symbols on Nuget (#1747) 3 years ago
ReactiveExample dea0e5696f added recommendations; fixed .sln 1 year ago
Scripts 9372cce69c Fixed Scenario tests 1 year ago
Terminal.Gui de92ea32b7 Fixed CM unit test failures causd by hotkey PR 1 year ago
UICatalog 3f973a2596 Merge branch 'v2_2144-3D-effect' of tig:tig/Terminal.Gui into v2_2144-3D-effect 1 year ago
UnitTests da899c3ba8 Fixed CM unit test failures causd by hotkey PR 1 year ago
docfx fab361d554 Updated CM schema 1 year ago
.dockerignore 8ab759b30f Fixes #415 v2. Colors: OpenSUSE - The native method "COLOR_PAIRS" does not exist 1 year ago
.editorconfig c94c0567dd Fixes #3240: editorconfig and project documentation sync with reformatting (#3241) 1 year ago
.filenesting.json 76d48f1fe8 Add solution default file nesting rules 1 year ago
.gitattributes 4522097c02 Forces the height of the TextField to 1 which is just the valid height instead of driver rows value. (#400) 5 years ago
.gitignore 49da66ab4f Added some stuff to gitignore to cover other common configurations 1 year ago
.vsconfig 1a68656d66 Add .vsconfig 1 year ago
Analyzers.slnf 4b34dc3f79 Add Analyzers-only solution filter 1 year ago
CODE_OF_CONDUCT.md 6144c9da66 added contribution guidelines, project layout docs, etc... 5 years ago
CONTRIBUTING.md c94c0567dd Fixes #3240: editorconfig and project documentation sync with reformatting (#3241) 1 year ago
Directory.Build.props a7a6038d39 Update that in the root, too 1 year ago
Directory.Build.targets cf9b8eda93 Improved DimPos tests 1 year ago
GitVersion.yml bcf675aa2c back to -pre 1 year ago
LICENSE 38af4cfcb8 Add 7 years ago
NoSamples.slnf f03817da1b Have to add this back in temporarily 1 year ago
README.md 6dd349fdf3 Doc improvements 1 year ago
Release.ps1 27edf992c5 more gitversion stuff 2 years ago
Release.slnf 902a672c5a This one needs the unit test project too for now 1 year ago
Terminal.sln 437e846ef5 Organized the solution items to make things easier to find 1 year ago
Terminal.sln.DotSettings 3f29a96b33 Split out the todo list items and unify their definitions 1 year ago
Terminal.sln.ToDo.DotSettings 3f29a96b33 Split out the todo list items and unify their definitions 1 year ago
global.json dcb3b359ad Fixes #2926 - Refactor KeyEvent and KeyEventEventArgs to simplify (#2927) 1 year ago
nuget.config 1e4634c828 Add packageSourceMapping to match the custom nuget packageSource 1 year ago
pull_request_template.md b84862d0bd Fixes #3172. `Application.ResetState` wasn't resetting all it should (#3173) 1 year ago
testenvironments.json 8ea6b105fc Fixes #2923. Ensures only clear Instances if they really was disposed. (#2924) 1 year ago

README.md

Terminal.Gui .NET Core Code scanning - action Version Code Coverage Downloads License Bugs

The current, stable, release of Terminal.Gui is v1.x. It is stable, rich, and broadly used. The team is now focused on designing and building a significant upgrade we're referring to as v2. Therefore:

  • v1 is now in maintenance mode, meaning we will accept PRs for v1.x (the develop branch) only for issues impacting existing functionality.
  • All new development happens on the v2_develop branch. See the V2 discussion here.
  • Developers are encouraged to continue building on v1.x until we announce v2 is stable.

Terminal.Gui: A toolkit for building rich console apps for .NET, .NET Core, and Mono that works on 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

Showcase & Examples

  • UI Catalog - The UI Catalog project provides an easy to use and extend sample illustrating the capabilities of Terminal.Gui. Run dotnet run --project UICatalog to run the UI Catalog.
  • C# Example - Run dotnet run in the Example directory to run the C# Example.
  • F# Example - An example showing how to build a Terminal.Gui app using F#.
  • Reactive Example - A sample app that shows how to use System.Reactive and ReactiveUI with Terminal.Gui. The app uses the MVVM architecture that may seem familiar to folks coming from WPF, Xamarin Forms, UWP, Avalonia, or Windows Forms. In this app, we implement the data bindings using ReactiveUI WhenAnyValue syntax and Pharmacist — a tool that converts all events in a NuGet package into observable wrappers.
  • PowerShell's Out-ConsoleGridView - OCGV sends the output from a command to an interactive table.
  • F7History - Graphical Command History for PowerShell (built on PowerShell's Out-ConsoleGridView).
  • PoshRedisViewer - A compact Redis viewer module for PowerShell written in F#.
  • PoshDotnetDumpAnalyzeViewer - dotnet-dump UI module for PowerShell.
  • TerminalGuiDesigner - Cross platform view designer for building Terminal.Gui applications.

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.