#keyboard #sgr #termina

termina

A cross-platform VT manipulation library

1 unstable release

new 0.1.0-beta.1 Apr 8, 2025

#347 in Hardware support

Download history 124/week @ 2025-04-07

124 downloads per month

MIT OR MPL-2.0

175KB
3.5K SLoC

Termina

Crates.io Documentation

A cross-platform "virtual terminal" (VT) manipulation library.

Termina only "speaks text/VT" but aims to work on Windows as well as *NIX. This is made possible by Microsoft's investment into ConPTY. This means that Termina requires 64-bit Windows 10.0.17763 (released around Fall 2018) or later (same as WezTerm).

Termina is a cross between Crossterm and TermWiz with a lower level API which exposes escape codes to consuming applications. The aim is to scale well in the long run as terminals introduce VT extensions like the Kitty Keyboard Protocol or Contour's Dark/Light mode detection - those requiring minimal changes in Termina and also allowing flexibility in how applications detect and handle these extensions. See examples/event-read.rs for a look at a basic API.

Credit

Termina contains significant code sourced and/or modified from other projects, especially Crossterm and TermWiz. See "CREDIT" comments in the source for details on what was copied and what modifications were made. Since all copied code is licensed under MIT, Termina is offered under the MIT license as well at your option.

License

Licensed under either of:

at your option.

Dependencies

~2–12MB
~156K SLoC