#tui #user-interface #text #ui #game-engine #terminal-interface #terminal-game

rusty_textui

Library for creating simple text user interfaces, like text arcade games in the terminal

3 unstable releases

0.2.1 Nov 21, 2023
0.2.0 Nov 21, 2023
0.1.0 Nov 10, 2023

#2076 in Game dev

MIT/Apache

13KB
201 lines

Rusty Text UI (rusty_textui)

rusty_textui is a simple Text UI engine intended to be used by people who are just beginning to learn Rust. It has a simple interface with enough functionality to easily create a terminal-based game or application. I created it specifically for students of my Ultimate Rust Crash Course to use to for their course projects. You may want to use this together with rusty_audio to produce sound, and rusty_time for timers.

Quick Start

In your terminal, add rusty_textui to your project:

cargo add rusty_textui

In your code:

use rusty_textui::prelude::*; // Bring all the important stuff into scope

fn main() {
    // Create the screen
    let mut screen = Screen::new(80, 25, false);

    // Set up game/application logic
    let mut player_col: usize = 0;

    // Set up a main loop, with a label so it can be exited easily
    'mainloop: loop {
        // Handle user input
        for key_event in screen.get_key_events() {
            match key_event.code {
                KeyCode::Right => player_col = (player_col + 1).clamp(0, 79),
                KeyCode::Left => player_col = player_col.saturating_sub(1),
                KeyCode::Esc => break 'mainloop, // Esc key exits the main loop
                _ => {}
            }
        }

        // Draw the current state of everything
        screen.draw(player_col, 12, "X", Color::Blue);

        // Flip the frames so the one we drew to is visible, and a new blank frame is ready for us
        // to draw the next frame to.
        screen.flip();
    }
}

Contribution

All contributions are assumed to be dual-licensed under MIT/Apache-2.

License

Distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See license/APACHE and license/MIT.

Sponsor

If you like Rusty Audio, please consider sponsoring me on GitHub. 💖

Dependencies

~0.8–6.5MB
~20K SLoC