libghostty-vt is a C library which implements a modern terminal emulator, extracted from the Ghostty terminal emulator.

libghostty-vt contains the logic for handling the core parts of a terminal emulator: parsing terminal escape sequences, maintaining terminal state, encoding input events, etc. It can handle scrollback, line wrapping, reflow on resize, and more.

Warning: This library is currently in development and the API is not yet stable. Breaking changes are expected in future versions. Use with caution in production code.

API Reference

The API is organized into the following groups:

Key Encoding - Encode key events into terminal sequences
OSC Parser - Parse OSC (Operating System Command) sequences
SGR Parser - Parse SGR (Select Graphic Rendition) sequences
Paste Utilities - Validate paste data safety
Memory Management - Memory management and custom allocators
WebAssembly Utilities - WebAssembly convenience functions

Examples

Complete working examples:

c-vt/src/main.c - OSC parser example
c-vt-key-encode/src/main.c - Key encoding example
c-vt-paste/src/main.c - Paste safety check example
c-vt-sgr/src/main.c - SGR parser example