snailshell 0.1.0

Library for making terminal text display with pleasant RPG-style animations.
Documentation

🐌 snailshell

A tiny library and application for animating text in the terminal.

demo

☝️ From Fun Stuff example. (obviously looks smoother in an actual terminal)

Easily add some flair to your text RPGs or console programs.

👩‍🏫 Examples


Basic

use snailshell::*;

// It's dead simple.
snailprint("hello, friend :)");

Custom Fixed Duration

snailprint_d("This whole message will print in half a second regardless of the size.", 0.5);

Refresh Rate

// This is optional. Default fps is 60.
// All subsequent snailprint functions will use this fps.
set_snail_fps(30);

🐌🖥️ Snailshell Standalone:

You can also use snailshell from the command line.

cli demo

Useful for making shell scripts and videos!

Installation:

cargo install snailshell

Usage:


snailshell [OPTIONS] <TEXT>

ARGS:
<TEXT>    Text you want to animate

OPTIONS:
-d, --duration <DURATION>    How long the text should animate for
-f, --fps <FPS>              Refresh rate of animation
-h, --help                   Print help information
-s, --speed <SPEED>          Constant speed of chars per second to render. Conflicts with duration

Example

snailshell "text you want to animate"

📖 License


This crate is licensed under the MIT license.