Tutu 1.0.0

Tutu

Cross-platform Terminal Manipulation Library

Tutu is a pure-csharp, terminal manipulation library that makes it possible to write cross-platform text-based interfaces. It supports all UNIX and Windows terminals down to Windows 7 (not all terminals are tested). It is heavily inspired by the Rust library cross-term

Table of Contents

• Cross-platform Terminal Manipulation Library
  • Table of Contents
  • Features
    • Tested Terminals
  • Getting Started
    • Feature Flags
    • Dependency Justification
    • Other Resources
  • Used By
  • Contributing
  • Authors
  • License

Features

• Cross-platform
• Multi-threaded (send, sync)
• Detailed documentation
• Few dependencies
• Full control over writing and flushing output buffer
• Is tty
• Cursor
  • Move the cursor N times (up, down, left, right)
  • Move to previous / next line
  • Move to column
  • 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
  • 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
  • Clear (all lines, current line, from cursor down and up, until new line)
  • Scroll up, down
  • Set/get the terminal size
  • Exit current process
  • Alternate screen
  • Raw screen
  • Set terminal title
  • Enable/disable line wrapping
• Event
  • Input Events
  • Mouse Events (press, release, position, button, drag)
  • Terminal Resize Events
  • Advanced modifier (SHIFT | ALT | CTRL) support for both mouse and key events and
  • futures Stream (feature 'event-stream')
  • Poll/read API

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

see the examples directory.

using Tutu;
using static Tutu.Commands.Style;

public static void Main()
{
    Console.Out
        .Execute(
            SetForegroundColor(Color.Blue),
            SetBackgroundColor(Color.Red),
            Print("Styled text here."),
            ResetColor
        );
}

Authors

• Rafael Andrade - Project Owner & creator