Skip to content
Snippets Groups Projects
README.md 1.23 KiB
Newer Older
Ticki's avatar
Ticki committed
Termion
Ticki's avatar
Ticki committed
=======

A pure Rust library for handling, manipulating and reading information about terminals. This provides a full-featured alternative to Termbox.

Ticki's avatar
Ticki committed
Supports Redox and POSIX. Untested on Windows.

Ticki's avatar
Ticki committed
[Documentation.](http://ticki.github.io/termion/termion/) | [Examples.](https://github.com/Ticki/termion/tree/master/examples)

Ticki's avatar
Ticki committed
A note on stability
-------------------

This crate is not stable, yet. However, if you do want stability, you should specify the revision (commit hash) in your `Cargo.toml`, this way builds are complete reproducible, and won't break.

Features
--------

- Raw mode.
- Cursor movement.
- Color output.
- Text formatting.
- Console size.
- Control sequences.
- Termios control.
- Password input.
Ticki's avatar
Ticki committed
- Redox support.
- 256-color mode.
- Panic-free error handling.
Ticki's avatar
Ticki committed
- Special keys events (modifiers, special keys, etc.).
- Asynchronous key events.
Ticki's avatar
Ticki committed

and much more.
Ticki's avatar
Ticki committed
Usage
-----

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

Antonin Carette's avatar
Antonin Carette committed
For a more complete example, see [a minesweeper implementation](https://github.com/redox-os/games-for-redox/blob/master/src/minesweeper/main.rs), that I made for Redox using termion.
Ticki's avatar
Ticki committed

Ticki's avatar
Ticki committed
<img src="image.png" width="150">

Ticki's avatar
Ticki committed

TODO
----

- Mouse input
Ticki's avatar
Ticki committed

License
-------

MIT.