Termion

Termion is a pure Rust, bindless library for low-level handling, manipulating and reading information about terminals. This provides a full-featured alternative to Termbox.

Termion aims to be simple and yet expressive. It is bindless, meaning that it is not a front-end to some other library (e.g., ncurses or termbox), but a standalone library directly talking to the TTY.

Supports Redox, Mac OS X, and Linux (or, in general, ANSI terminals).

Documentation. | Examples.

A note on stability

Although small breaking changes might happen, I will try my best to avoid them, and this crate can generally be considered stable.

Cargo.toml

For nightly, add

[dependencies.termion]
git = "https://github.com/ticki/termion.git"

For stable,

[dependencies.termion]
git = "https://github.com/ticki/termion.git"
default-features = false

Features

• Raw mode.
• TrueColor.
• 256-color mode.
• Cursor movement.
• Color output.
• Calculating ANSI escapes.
• Text formatting.
• Console size.
• Control sequences.
• Termios control.
• Password input.
• Redox support.
• Safe isatty wrapper.
• Panic-free error handling.
• Special keys events (modifiers, special keys, etc.).
• Allocation-free.
• Asynchronous key events.
• Carefully tested.

and much more.

Example

extern crate termion;

use termion::{color, style};

use std::io;

fn main() {
    println!("{}Red", color::Fg(color::Red));

    println!("{}Blue", color::Fg(color::Blue));

    println!("{}Blue'n'Bold{}", style::Bold, style::Reset);

    println!("{}Just plain italic", style::Italic);
}

Usage

See examples/, and the documentation, which can be rendered using cargo doc.

For a more complete example, see a minesweeper implementation, that I made for Redox using termion.

TODO

• Mouse input

License

MIT/X11.