Popularity
7.4
Growing
Activity
8.8
Growing
461
17
50

Monthly Downloads: 1,308
Programming language: Rust
License: MIT License
Tags: Terminal     Tui     Color     Console     Input     Command-line     Cursor    
Latest version: v0.13.3

crossterm alternatives and similar packages

Based on the "TUI" category

Do you think we are missing an alternative of crossterm or a related project?

Add another 'TUI' Package

README

Donate Travis Latest Version [MIT][l2] docs Lines of Code Join us on Discord

Cross-platform Terminal Manipulation Library

Have you ever been disappointed when a terminal library for the Rust language was only written for UNIX systems? Crossterm provides clearing, input handling, styling, cursor movement and terminal actions for both Windows and UNIX systems.

Crossterm aims to be simple and easy to call in code. Through the simplicity of Crossterm, you do not have to worry about the platform you are working with.

This crate supports all UNIX and Windows terminals down to Windows 7 (not all terminals are tested, see Tested Terminals for more info).

Note on Migration

You may have noticed that Crossterm has been changing very quickly with the latest versions. We have done a lot of API-breaking changes by renaming functions, commands, changing the exports, improving the encapsulation, etc. However, all of this happens to improve the library and make it better and ready for a possible 1.0 release. We want to stick to the Command API and remove all other ways to use crossterm. Try to use this API and change your code accordingly. This way you will survive or overcome major migration problems ;).

We hope you can understand this, feel free to ask around in discord if you have questions. For up-to-date examples, have a look at the examples repository. Sorry for the inconvenience.

It's highly recommended to read the Upgrade from 0.13 to 0.14 documentation, which explains everything you need to know.

Table of Contents

Features

  • Cross-platform
  • Multi-threaded (send, sync)
  • Detailed documentation
  • Few dependencies
  • Full control over output buffer
  • Cursor (feature cursor)
    • Move the cursor N times (up, down, left, right)
    • Set/get the cursor position
    • Store the cursor position and restore to it later
    • Hide/show the cursor
    • Enable/disable cursor blinking (not all terminals do support this feature)
  • Styled output (feature style)
    • Foreground color (16 base colors)
    • Background color (16 base colors)
    • 256 (ANSI) color support (Windows 10 and UNIX only)
    • RGB color support (Windows 10 and UNIX only)
    • Text attributes like bold, italic, underscore, crossed, etc.
  • Terminal (feature terminal)
    • Clear (all lines, current line, from cursor down and up, until new line)
    • Scroll up, down
    • Set/get the terminal size
    • Exit current process
  • Input (feature input)
    • Read character
    • Read line
    • Read key input events (async / sync)
    • Read mouse input events (press, release, position, button)
  • Screen (feature screen)
    • Alternate screen
    • Raw screen

<!-- WARNING: Do not change following heading title as it's used in the URL by other crates! -->

Tested Terminals

  • Windows Powershell
    • Windows 10 (Pro)
  • Windows CMD
    • Windows 10 (Pro)
    • Windows 8.1 (N)
  • Ubuntu Desktop Terminal
    • Ubuntu 17.10
  • (Arch, Manjaro) KDE Konsole
  • Linux Mint

This crate supports all UNIX terminals and Windows terminals down to Windows 7; however, not all of the terminals have been tested. If you have used this library for a terminal other than the above list without issues, then feel free to add it to the above list - I really would appreciate it!

Getting Started

Click to show Cargo.toml.

[dependencies]
crossterm = "0.13"
use std::io::{stdout, Write};

use crossterm::{execute, ExecutableCommand, style::{Attribute, Color, SetForegroundColor, SetBackgroundColor, ResetColor}, Output, Result};

fn main() -> Result<()> {
    // using the macro
    execute!(
        stdout(),
        SetForegroundColor(Color::Blue),
        SetBackgroundColor(Color::Red),
        Output("Styled text here."),
        ResetColor
    )?;

    // or using functions
    stdout()
        .execute(SetForegroundColor(Color::Blue))?
        .execute(SetBackgroundColor(Color::Red))?
        .execute(Output("Styled text here."))?
        .execute(ResetColor)?;

    Ok(())
}

Checkout this list with all possible commands.

Feature Flags

All features are enabled by default. You can disable default features and enable some of them only.

[dependencies.crossterm]
version = "0.12"
default-features = false        # Disable default features
features = ["cursor", "screen"] # Enable required features only
Feature Description
input Sync/Async input readers
cursor Cursor manipulation
screen Alternate screen & raw mode
terminal Size, clear, scroll
style Colors, text attributes

Other Resources

Used By

Contributing

I highly appreciate when anyone contributes to this crate. Before you do, please, read the [Contributing](docs/CONTRIBUTING.md) guidelines.

Authors

  • Timon Post - Project Owner & creator

Support

Would you like Crossterm to be even more gorgeous and beautiful? You can help with this by donating.

paypal

License

This project, crossterm and all it's sub-crates: crossterm_screen, crossterm_cursor, crossterm_style, crossterm_input, crossterm_terminal, crossterm_winapi, crossterm_utils are licensed under the MIT License - see the LICENSE file for details.


*Note that all licence references and agreements mentioned in the crossterm README section above are relevant to that project's source code only.