#terminal #tui #vt100 #curses

textmode

terminal interaction library backed by a real terminal parser

8 releases

0.4.1 Jan 30, 2025
0.4.0 Mar 8, 2023
0.3.0 Dec 15, 2021
0.2.2 Dec 6, 2021
0.1.0 Mar 13, 2021

#692 in Asynchronous

Download history 4/week @ 2024-12-01 19/week @ 2024-12-08 4/week @ 2024-12-15 1/week @ 2025-01-12 2/week @ 2025-01-19 101/week @ 2025-01-26 58/week @ 2025-02-02 10/week @ 2025-02-09

171 downloads per month
Used in ttyrec-bin

MIT license

59KB
1K SLoC

textmode

textmode is a library for terminal interaction built on top of a real terminal parsing library. It allows you to do arbitrary drawing operations on an in-memory screen, and then update the visible terminal output to reflect the in-memory screen via an optimized diff algorithm when you are finished. Being built on a real terminal parsing library means that while normal curses-like operations are available:

use textmode::Textmode;
let mut tm = textmode::Output::new().await?;
tm.clear();
tm.move_to(5, 5);
tm.set_fgcolor(textmode::color::RED);
tm.write_str("foo");
tm.refresh().await?;

you can also write data containing arbitrary terminal escape codes to the output and they will also do the right thing:

tm.write(b"\x1b[34m\x1b[3;9Hbar\x1b[m");
tm.refresh().await?;

This module is split into two main parts: Output and Input. See the documentation for those types for more details. Additionally, the blocking module provides an equivalent interface with blocking calls instead of async.

Dependencies

~3–13MB
~165K SLoC