ansi-to-tui
| Crates.io | ansi-to-tui |
| lib.rs | ansi-to-tui |
| version | 8.0.1 |
| created_at | 2021-04-30 23:00:51.32654+00 |
| updated_at | 2026-01-10 05:25:30.989758+00 |
| description | Convert ANSI color and style codes into Ratatui Text |
| homepage | https://ratatui.rs |
| repository | https://github.com/ratatui/ansi-to-tui |
| max_upload_size | |
| id | 391732 |
| size | 236,189 |
Core (github:ratatui:core)
documentation
https://docs.rs/ansi-to-tui
README
ansi-to-tui
Convert ANSI color and style codes into Ratatui Text.
This crate parses bytes containing ANSI SGR escape sequences (like \x1b[31m).
It produces a Ratatui Text with equivalent foreground/background Color and
Modifier settings via Style.
Unknown or malformed escape sequences are ignored so you can feed it real terminal output without having to pre-clean it.
| Color Mode | Supported | SGR Example | Ratatui Color Example |
|---|---|---|---|
| Named (3/4-bit, 8/16-color) | ✓ | \x1b[30..37;40..47m |
Color::Blue |
| Indexed (8-bit, 256-color) | ✓ | \x1b[38;5;<N>m |
Color::Indexed(1) |
| Truecolor (24-bit RGB) | ✓ | \x1b[38;2;<R>;<G>;<B>m |
Color::Rgb(255, 0, 0) |
Example
use ansi_to_tui::IntoText as _;
let buffer = std::fs::read("ascii/text.ascii")?;
let output = buffer.into_text()?;
Contributing and CI details are in CONTRIBUTING.md.