Overview

Typio is a lightweight Python library that prints text to the terminal as if it were being typed by a human. It supports multiple typing modes (character, word, line, sentence, typewriter, and adaptive), configurable delays and jitter for natural variation, and seamless integration with existing code via a simple function or a decorator. Typio is designed to be minimal, extensible, and safe, making it ideal for demos, CLIs, tutorials, and storytelling in the terminal.

Installation

Source Code

• Download Version 1.3 or Latest Source
• pip install .

PyPI

• Check Python Packaging User Guide
• pip install typio==1.3

Usage

Function

Use type_print function to print text with human-like typing effects. You can control the typing speed, randomness, mode, output stream, and output flushing behavior.

Example

from typio import type_print
from typio import TypeMode

type_print("Hello, world!")

type_print(
    "Typing with style and personality.",
    delay=0.06,
    jitter=0.02,
	end="\n",
    mode=TypeMode.ADAPTIVE,
    flush=False,
)

You can also redirect the output to any file-like object:

with open("output.txt", "w") as file:
    type_print("Saved with typing effects.", file=file)

Parameters

Built-in Modes

Decorator

Use the @typestyle decorator to apply typing effects to all print calls inside a function, without changing the function's implementation.

Example

from typio import typestyle
from typio import TypeMode

@typestyle(delay=0.05, mode=TypeMode.TYPEWRITER, flush=True)
def intro():
    print("Welcome to Typio.")
    print("Every print is typed.")

intro()

Parameters

Custom Mode

Typio also allows defining custom typing modes.

A custom mode is a callable that receives a typing context and the text being printed.

Example

This custom mode, named dramatic, adds exaggerated pauses after punctuation to create a dramatic typing effect.

from typio import TypioContext

def dramatic(ctx: TypioContext, text: str):
    for ch in text:
        ctx.emit(ch)
        if ch in ".!?":
            ctx.sleep(delay=ctx.delay * ctx.random.uniform(3, 7))

Usage with type_print function:

type_print(
    "Wait... what?!",
    mode=dramatic,
    delay=0.05,
    jitter=0.02,
    flush=True
)

Usage with @typestyle decorator:

@typestyle(delay=0.06, mode=dramatic, flush=True)
def demo():
    print("This is serious.")
    print("Very serious!")

demo()

Parameters

This table describes the TypioContext API, which is the interface exposed to custom typing modes for emitting text, controlling timing, and accessing delay settings.

CLI

Typio provides a simple command line interface for printing text with typing effects.

Example

> typio "Hello world!" --mode=typewriter --delay=0.03

Pass --seed to make randomized modes reproducible:

> typio "Hello world!" --mode=glitch --seed=42

Screen Record

Issues & Bug Reports

Just fill an issue and describe it. We'll check it ASAP!

• Please complete the issue template

Show Your Support

Star This Repo

Give a ⭐️ if this project helped you!

Donate to Our Project

Bitcoin

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete