Terminal.Gui Documentation

Important

Terminal.Gui v2 "Alpha" has been released.

Welcome to the Terminal.Gui documentation! This comprehensive guide covers everything you need to know about building modern terminal user interfaces with Terminal.Gui.

Note

This is the v2 API documentation. For v1 go here: https://gui-cs.github.io/Terminal.GuiV1Docs/

Getting Started

• Getting Started - Quick start guide to create your first Terminal.Gui application
• Migrating from v1 to v2 - Complete guide for upgrading existing applications
• What's New in v2 - Overview of new features and improvements

Deep Dives

• ANSI Response Parser - Terminal sequence parsing and state management
• Cancellable Work Pattern - Core design pattern for extensible workflows
• Character Map Scenario - Complex drawing, scrolling, and Unicode rendering example
• Command System - Command execution, key bindings, and the Selecting/Accepting concepts
• Configuration Management - Persistent settings, themes, and configuration scopes
• Cross-Platform Driver Model - Platform abstraction and console driver architecture
• Cursor System - Modern cursor management and positioning (proposed design)
• Dim.Auto - Automatic view sizing based on content
• Events - Event patterns and handling throughout the framework
• Keyboard Input - Key handling, bindings, commands, and shortcuts
• Layout System - View positioning, sizing, and arrangement
• Lexicon & Taxonomy - Terminology and concepts used throughout Terminal.Gui
• Logging & Metrics - Comprehensive logging and performance monitoring
• Multitasking - Application lifecycle and event dispatching
• Mouse Input - Mouse event handling and interaction patterns
• Navigation - Focus management, keyboard navigation, and accessibility
• Popovers - Drawing outside viewport boundaries for menus and popups
• Scrolling - Built-in scrolling, virtual content areas, and scroll bars

API Reference

For detailed API documentation, see the API Reference.