Terminal text effects, ASCII art banners, and mascot displays — zero dependencies.

These details have not been verified by PyPI

Project links

Project description

Python Version License Tests Zero Deps

TypeFx

Terminal text effects, ASCII art banners, and mascot displays — zero dependencies.

TypeFx brings your terminal applications to life with dynamic typing effects, customizable banner templates, 55+ ASCII art animals, 600+ kaomoji expressions, and 90+ Unicode emoji symbols — all with zero external dependencies.

Quick Start
Installation
Features
Decorator
Command-Line Interface
Full API Reference
Configuration
Examples Gallery
Contributing
Code of Conduct
License

Quick Start

from typefx import project_banner, hero_banner, alert_banner, progress_bar, tag, divider, animal, kaomoji, buddy
from typefx.colors import BRIGHT_CYAN, CYAN, GREEN

# Project banner
print(project_banner("MyApp", tagline="v2.0", version="1.0.0"))

# Alert
print(alert_banner("Server started", level="success", width=50))

# Progress bar
print(progress_bar(75, width=20, label="Loading", color=GREEN))

# ASCII animal
print(animal("dragon"))

# Buddy mascot
buddy("MyApp", animal_name="cat1", color=BRIGHT_CYAN, message="Ready!")

Installation

pip install PyTypeFx

Or from source:

git clone https://github.com/rkriad585/PyTypeFx.git
cd PyTypeFx
pip install -e .

Features

Typing Effects

All 18 writers share consistent parameters: text, delay, color, style, position.

from typefx import TypeWriter, RainbowWriter, GlitchWriter, GradientWriter, BounceWriter

# Classic typewriter
TypeWriter("Hello, World!", delay=0.05)

# Rainbow cycling text
RainbowWriter("Rainbow effect!", delay=0.03)

# Glitch / distortion effect
GlitchWriter("SYSTEM ONLINE", delay=0.05, color="green")

# Smooth color gradient
GradientWriter("Gradient text", start_hex="#FF0000", end_hex="#0000FF")

# Bounce animation
BounceWriter("BOUNCE!", delay=0.08, color="cyan")

# Loop write-delete animation
LoopWriter("Loading...", loops=5, delay=0.03, color="yellow")

# Game-style dialog box
GameDialog("Hello, adventurer!", delay=0.03, color="green")

# Markdown rendering
MarkdownWriter("This is **bold** and *italic* text.")

# HTML rendering
HTMLWriter("This is <b>bold</b> and <i>italic</i> text.")

# Reverse type
ReverseWriter("Reverse text")

# Thinking animation with blinking dots
ThinkWriter("Analyzing...", color="cyan")

# Ghost autocomplete suggestion
AutoCompleteWriter("autocomplete", color="bright_black")

Full writer list:

Writer	Effect
`TypeWriter`	Standard character-by-character typing
`RainbowWriter`	Rainbow color cycling
`HexWriter`	Custom hex color cycling
`DelWriter`	Type then delete
`LoopWriter`	Repeated type-delete loop
`SoundWriter`	Type with beep sounds
`GameDialog`	Game-style dialog box
`RandomWriter`	Random color per character
`MarkdownWriter`	Renders `bold`, `italic`, `__underline__`
`HTMLWriter`	Renders `<b>`, `<i>`, `<u>`, `<s>`, `<blink>`
`GlitchWriter`	Glitch/distortion effect
`ThinkWriter`	Blinking ellipsis before text
`ReverseWriter`	Reverse order typing
`ReverseGlitchWriter`	Reverse + glitch combined
`BounceWriter`	Bounce highlight effect
`BounceGlitchWriter`	Bounce + glitch combined
`GradientWriter`	Smooth hex-to-hex gradient
`AutoCompleteWriter`	Ghost autocomplete suggestion

Banners & ASCII Art

Every banner function accepts optional color, align, padding, width, border_color, and title_color parameters with full backward compatibility.

from typefx import box, project_banner, hero_banner, alert_banner, progress_bar, tag, divider, frame, centered_banner, section_header, banner_block, banner_arrow, banner_dash, rule, color_art
from typefx.colors import BRIGHT_CYAN, CYAN, GREEN, YELLOW, RED, MAGENTA

# --- Box Layouts (7 styles) ---
print(box("Hello"))                                          # single box
print(box("Content", style="double", title="Output"))        # double-line
print(box("Rounded", style="rounded"))                       # rounded corners
print(box("Heavy", style="heavy"))                           # thick lines
print(box("ASCII", style="ascii"))                           # pure ASCII +-*/

# Fully customized box
print(box("Customized", color=BRIGHT_CYAN, align="center", padding=1, width=30, title="Demo", title_color=GREEN, border_color=CYAN))

# --- Project Banner ---
print(project_banner("MyApp", tagline="Terminal Text Effects", version="2.0.1", color=BRIGHT_CYAN, accent=GREEN))

# --- Hero Banner ---
print(hero_banner("Welcome to MyApp", color=BRIGHT_CYAN, width=60))

# --- Alert Banners (5 levels) ---
print(alert_banner("Everything OK", level="success", width=50))
print(alert_banner("Disk at 85%", level="warning", width=50))
print(alert_banner("Server down", level="error", width=50))
print(alert_banner("Connection lost", level="critical", width=50))

# --- Progress Bars ---
print(progress_bar(25, width=20, label="Download"))
print(progress_bar(50, width=20, label="Processing", color=YELLOW))
print(progress_bar(100, width=20, label="Complete", color=GREEN, show_percent=True))

# --- Tags / Badges ---
print(tag("INFO", color=BRIGHT_CYAN, bracket="square"))
print(tag("URGENT", color=RED, bracket="curly"))

# --- Dividers ---
print(divider(length=50, label="Section", color=CYAN, align="center"))
print(divider(length=40, fill="~", label="Chapter 1", color=YELLOW))

# --- Frames ---
print(frame("  Hello\n  World", box_style="double"))
print(color_art("  ╔═══╗\n  ║ ♥ ║\n  ╚═══╝", color=RED))

# --- Centered Banner ---
print(centered_banner("★ PyTypeFx ★", width=50, color=BRIGHT_CYAN, fill="="))

# --- Section Header ---
print(section_header("Features", color=CYAN, align="center"))

# --- Banner Block with arrow ---
print(banner_block("Main Title", color=BRIGHT_CYAN, align="center"))
print(banner_arrow("Next Step", color=GREEN))
print(banner_dash("Item", color=CYAN))

# --- Rule ---
print(rule(color=CYAN))

Full banner function list:

Function	Description
`box()`	Multi-style box layouts (7 styles)
`project_banner()`	Full project header with name, tagline, version
`hero_banner()`	Big attention-grabbing header
`alert_banner()`	Contextual alerts (info/success/warning/error/critical)
`progress_bar()`	Visual progress bars with labels
`tag()`	Badges and labels
`divider()`	Horizontal dividers with labels
`frame()`	Frame ASCII art inside boxes
`centered_banner()`	Text centered between fill characters
`section_header()`	Section header with decorative borders
`banner_block()`	Large banner block with top/bottom borders
`banner_arrow()`	Arrow-pointing banner
`banner_dash()`	Dashed prefix banner
`rule()`	Colored horizontal rule
`color_art()`	Color existing ASCII art
`buddy()`	Combine animal + project name
`buddy_box()`	Buddy mascot inside a box
`buddy_multi()`	Multiple animals side-by-side

ASCII Animals

55+ built-in ASCII art animals. Display one by name, or get a random one.

from typefx import animal, animal_names

# Specific animal
print(animal("dragon"))
#   /\_/\  
#  ( o.o ) 
#   > ^ <  

print(animal("cat1"))
#   /\_/\  
#  ( o.o ) 
#   > ^ <  

print(animal("penguin1"))
#  .---.
# /     \
#  \.-.-./

# Random animal
print(animal())

# List all available names
names = animal_names()
print(len(names))  # 55+

Available animals: cat1, cat2, cat_love, dog1, dog2, dog_sleep, bear, penguin1, penguin2, penguin_dance, bunny1, bunny2, bunny3, bird, fish, fox, pig, frog, koala, panda, turtle, monkey, octopus1, octopus2, lion, horse, cow, sheep, elephant, whale, dolphin, shark, snake, spider, butterfly, parrot, eagle, wolf, deer, chicken, hamster, mouse, sloth, dragon, bat, seal, crab, dino, and more.

Kaomoji

600+ Japanese emoticons across 30 categories.

from typefx import kaomoji, kaomoji_categories

# By category
print(kaomoji("happy"))    # (◕‿◕✿)
print(kaomoji("love"))     # ♥‿♥
print(kaomoji("fight"))    # (งಠ_ಠ)ง
print(kaomoji("cat"))      # (=^‥^=)
print(kaomoji("dance"))    # └(^‿^)┘
print(kaomoji("party"))    # d(^‿^)b
print(kaomoji("magic"))    # (∩‿∩)⊃━☆ﾟ.*･｡ﾟ
print(kaomoji("sorry"))    # (シ_ _)シ
print(kaomoji("excited"))  # ヽ(°〇°)ﾉ
print(kaomoji("cold"))     # (っ◕‿◕)っ❄

# Random kaomoji
print(kaomoji())

# List categories
print(kaomoji_categories())

Categories: happy, sad, angry, love, shrug, cat, dog, bear, cute, surprise, sleep, dance, party, greeting, wave, hug, sorry, thank, excited, nervous, cool, run, fight, magic, food, drink, music, rain, star, flower, cold.

Emoji Symbols

90+ Unicode symbols organized by category.

from typefx import emoji, emoji_categories

# Get emoji by name
print(emoji("heart_red"))     # ♥
print(emoji("star"))          # ★
print(emoji("fire"))          # ♨
print(emoji("aries"))         # ♈
print(emoji("chess_king"))    # ♔
print(emoji("infinity"))      # ∞
print(emoji("euro"))          # €
print(emoji("sun"))           # ☀
print(emoji("peace"))         # ☮

# Random emoji
print(emoji())

# List categories
print(emoji_categories())

Categories: hearts, stars, zodiac, chess, math, arrows, currency, weather, geometric, music, misc.

Buddy / Mascot System

Combine any ASCII animal with a project name for mascot displays.

from typefx import buddy, buddy_box, buddy_multi
from typefx.colors import BRIGHT_CYAN, GREEN, MAGENTA

# Single mascot
buddy("MyApp", animal_name="cat1", color=BRIGHT_CYAN)

# With message
buddy("MyApp", animal_name="penguin2", color=BRIGHT_CYAN,
      message="Making terminals beautiful!")

# Boxed mascot
buddy_box("MyApp", tagline="v2.0", animal_name="fox", color=BRIGHT_CYAN)

# Multi-animal team (aligned side-by-side)
buddy_multi("MyApp", animal_names=["cat1", "fox", "penguin2"],
            color=BRIGHT_CYAN)

Color System

from typefx.colors import (
    RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE,
    BRIGHT_RED, BRIGHT_GREEN, BRIGHT_CYAN, BRIGHT_WHITE,
    ORANGE, PINK, TEAL, CORAL, MINT, PLUM, GOLD,
    BG_RED, BG_GREEN, BG_CYAN,
    BOLD, UNDERLINE, ITALIC, INVERT, STRIKETHROUGH,
    hex_to_ansi, rgb_to_ansi, colorize
)

# Apply multiple styles
print(colorize("Error!", RED, BOLD, UNDERLINE))

# Hex to ANSI
print(f"{hex_to_ansi('#FF5733')}Orange text{RESET}")

# RGB to ANSI
print(f"{rgb_to_ansi(100, 200, 255)}Custom RGB{RESET}")

# Use a palette
from typefx.colors import PALETTES
print(PALETTES["OCEAN"])   # ['#0077BE', '#0099CC', '#00BFFF', ...]
print(PALETTES["SUNSET"])  # ['#FF4500', '#FF6347', '#FF8C00', ...]

What's included:

16 basic + 16 bright ANSI colors
50+ extended named colors (Coral, Mint, Plum, Slate, Gold, etc.)
Background variants for all colors (BG_RED, BG_GREEN, ...)
HEX and RGB to ANSI converters
256-color 8-bit helpers (fg_256(), bg_256())
6 curated palettes: SUCCESS, ERROR, WARNING, INFO, NEON, PASTEL, OCEAN, SUNSET, FOREST, GARDEN, CYBER, NOIR, ROSE

Style Presets

40+ composable style presets for quick formatting.

from typefx.styles import apply_style, compose, ERROR, SUCCESS, WARNING, INFO, TITLE, HEADING, CODE, HIGHLIGHT, BANNER, NEON, GHOST

# Apply a preset
print(apply_style("Something went wrong!", ERROR))
print(apply_style("Task completed!", SUCCESS))
print(apply_style("Chapter 1", TITLE))
print(apply_style("Important note", HIGHLIGHT))
print(apply_style("Neon sign", NEON))

# Compose a custom style
from typefx.colors import BRIGHT_MAGENTA, BRIGHT_CYAN, INVERT, BOLD
custom = compose(BRIGHT_MAGENTA, BRIGHT_CYAN, INVERT, BOLD)
print(apply_style("Custom!", custom))

# Use with writers
from typefx import TypeWriter
TypeWriter("Banner text", **BANNER)
TypeWriter("Error text", **ERROR)

Decorator

The @typefx decorator applies typing effects to any function's output.

from PyTypeFx import typefx

@typefx(hex_colors=["#FF0000", "#00FF00", "#0000FF"], delay=0.03)
def my_message():
    print("This message will be typed out with a cool effect!")

my_message()

Command-Line Interface

# Basic
typefx --text "Hello from the CLI!" --delay 0.05 --rainbow

# From file
typefx --file message.txt --delay 0.03

# Random effect
typefx --text "Random text" --random

# Looping
typefx --text "Looping" --loops 5

CLI Options:

Option	Description
`-t`, `--text`	Text to type
`-d`, `--delay`	Delay between characters
`-l`, `--loops`	Loop count for `LoopWriter`
`-r`, `--rainbow`	Rainbow effect
`-rnd`, `--random`	Random writer effect
`-s`, `--sound`	Sound effect
`-f`, `--file`	Read text from a file

Full API Reference

`typefx.writers`

Function	Signature
`TypeWriter`	`(text, delay, color, style, reverse, position)`
`RainbowWriter`	`(text, delay, style, position)`
`HexWriter`	`(text, delay, style, position)`
`DelWriter`	`(text, delay, color, style, reverse, position)`
`LoopWriter`	`(text, delay, color, style, reverse, position, loops)`
`SoundWriter`	`(text, delay, color, style, reverse, position, frequency, duration)`
`GameDialog`	`(text, delay, color, style, position)`
`RandomWriter`	`(text, delay, style, position)`
`MarkdownWriter`	`(text, delay, style, position)`
`HTMLWriter`	`(text, delay, style, position)`
`GlitchWriter`	`(text, delay, color, style, position, glitch_chars, glitch_duration)`
`ThinkWriter`	`(text, delay, color, style, position)`
`ReverseWriter`	`(text, delay, color, style, position)`
`ReverseGlitchWriter`	`(text, delay, color, style, position)`
`BounceWriter`	`(text, delay, color, style, position)`
`BounceGlitchWriter`	`(text, delay, color, style, position)`
`GradientWriter`	`(text, delay, style, position, start_hex, end_hex)`
`AutoCompleteWriter`	`(text, delay, color, style, position, options)`

`typefx.banners`

Function	Description
`box(text, style, color, align, padding, width, title, title_color, border_color)`	Box layouts in 7 styles
`project_banner(name, tagline, version, color, accent)`	Full project header
`hero_banner(text, color, width)`	Large attention header
`alert_banner(text, level, width)`	5-level alert banners
`progress_bar(percent, width, label, color, show_percent, fill, empty)`	Progress bars
`tag(text, color, bracket)`	Badges / labels
`divider(length, label, fill, color, align)`	Horizontal dividers
`frame(art, box_style, color, padding)`	Frame ASCII art
`centered_banner(text, width, fill, color)`	Centered text banner
`section_header(text, color, align)`	Section headers
`banner_block(text, color, align, padding, width)`	Large banner block
`banner_arrow(text, color, align)`	Arrow banner
`banner_dash(text, color, align)`	Dashed banner
`rule(color, length)`	Colored horizontal rule
`color_art(art, color)`	Colorize ASCII art
`animal(name)`	Get ASCII animal
`animal_names()`	List all animal names
`kaomoji(category)`	Get kaomoji by category
`kaomoji_categories()`	List all kaomoji categories
`emoji(name)`	Get emoji by name
`emoji_categories()`	List all emoji categories
`buddy(name, animal_name, color, message)`	Mascot display
`buddy_box(name, tagline, animal_name, color)`	Boxed mascot
`buddy_multi(name, animal_names, color)`	Multi-animal mascot
`ALERT_STYLES`	Dict: info, success, warning, error, critical

`typefx.effects`

BlinkEffect(duration, cursor, delay) — Blinking cursor animation
SoundEffect(frequency, duration) — System beep sound

`typefx.colors`

hex_to_ansi(hex_color) — Hex to ANSI foreground
bg_hex_to_ansi(hex_color) — Hex to ANSI background
rgb_to_ansi(r, g, b) — RGB to ANSI foreground
bg_rgb_to_ansi(r, g, b) — RGB to ANSI background
fg_256(n) — 8-bit 256-color foreground
bg_256(n) — 8-bit 256-color background
colorize(text, *styles) — Apply ANSI codes to text

`typefx.styles`

compose(color, *formats) — Build style dict
apply_style(text, style) — Apply style to string

`typefx.utility`

gradient(text, start_hex, end_hex) — Apply gradient to text
supports_ansi() — Check terminal ANSI support

Configuration

The typefx.constant module contains all default values:

Constant	Default	Description
`TEXT`	`"Hello World!"`	Default text for writers
`GLITCH`	`"!@#$%^&*()..."`	Glitch character set
`CURSOR`	`_`	BlinkEffect cursor
`DELAY`	`0.05`	Default character delay
`HOLD`	`1`	DelWriter hold time
`LOOP`	`3`	Default loop count
`DOTS`	`3`	ThinkWriter dot count
`FREQUENCY`	`800`	Sound frequency
`SOUND_DURATION`	`30`	Sound duration
`START_HEX`	`"#E74C3C"`	Gradient start color
`END_HEX`	`"#2ECC71"`	Gradient end color

Examples Gallery

Gradient Text

from PyTypeFx import GradientWriter

GradientWriter("This is a beautiful gradient!", start_hex="#FF00FF", end_hex="#00FFFF", delay=0.02)

Game Dialog

from PyTypeFx import GameDialog

GameDialog(speaker="Hero", text="I must defeat the final boss!", delay=0.04, sound=True)

Chaining Effects

from PyTypeFx import TypeWriter, DelWriter, BlinkEffect

TypeWriter("Preparing for deletion...")
DelWriter("This message will self-destruct.", hold=2)
BlinkEffect(duration=2)

Alert Dashboard

from typefx import alert_banner, divider, box
from typefx.colors import CYAN

print(box("System Dashboard", style="double", align="center", width=60))
print(alert_banner("CPU: 45%", level="info"))
print(alert_banner("Memory: 72%", level="warning"))
print(alert_banner("Errors: 0", level="success"))
print(divider(length=60, fill="─", color=CYAN))

Multi-Animal Team Mascot

from typefx import buddy_multi
from typefx.colors import BRIGHT_CYAN

buddy_multi("PyTypeFx", animal_names=["dragon", "fox", "penguin2"],
            color=BRIGHT_CYAN)

Custom Box Style

from typefx import box
from typefx.colors import BRIGHT_CYAN, GREEN, CYAN

print(box("Welcome to TypeFx!\nZero dependencies.\n55+ animals. 600+ kaomoji.",
          style="double", color=BRIGHT_CYAN, align="center", padding=1,
          width=50, title="PyTypeFx", title_color=GREEN, border_color=CYAN))

Contributing

See CONTRIBUTING.md for development setup, testing, code style, and pull request guidelines.

Code of Conduct

This project follows the Contributor Covenant. See CODE_OF_CONDUCT.md for details.

License

This project is licensed under the MIT License. See the LICENSE file for details.

_{Built with ❤ by RK RIAD KHAN}

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

2.1.1

Jun 28, 2026

2.1.0

Jun 28, 2026

0.1.1

Jan 6, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytypefx-2.1.1.tar.gz (50.4 kB view details)

Uploaded Jun 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pytypefx-2.1.1-py3-none-any.whl (40.2 kB view details)

Uploaded Jun 28, 2026 Python 3

File details

Details for the file pytypefx-2.1.1.tar.gz.

File metadata

Download URL: pytypefx-2.1.1.tar.gz
Upload date: Jun 28, 2026
Size: 50.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pytypefx-2.1.1.tar.gz
Algorithm	Hash digest
SHA256	`0839968cd1076ee4afd14024dc91a3fed16ad3d4aaaf567378e445f8a543f7c8`
MD5	`f62390ccdf77318b3bf532c0c633271b`
BLAKE2b-256	`374f9fb278bc88c3e6a0bebe2b5cf2a3106b8f419b50a1dc64babb3c98619f84`

See more details on using hashes here.

File details

Details for the file pytypefx-2.1.1-py3-none-any.whl.

File metadata

Download URL: pytypefx-2.1.1-py3-none-any.whl
Upload date: Jun 28, 2026
Size: 40.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pytypefx-2.1.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`381607f686e4ef183380abee6fc628310cf52b78ab625eaa0176de67f3a83c17`
MD5	`8e8d4bd2aaccd0c99a0328d42b6018cd`
BLAKE2b-256	`c1ce7d6efe5cdaf20d7e6e53e1400eed33d75930d5067c3935b123edf0ef55d8`

See more details on using hashes here.

PyTypeFx 2.1.1

Navigation

Verified details

Maintainers

Meta

Unverified details

Project links

Meta

Classifiers

Project description

TypeFx

Table of Contents

Quick Start

Installation

Features

Typing Effects

Banners & ASCII Art

ASCII Animals

Kaomoji

Emoji Symbols

Buddy / Mascot System

Color System

Style Presets

Decorator

Command-Line Interface

Full API Reference

typefx.writers

typefx.banners

typefx.effects

typefx.colors

typefx.styles

typefx.utility

Configuration

Examples Gallery

Gradient Text

Game Dialog

Chaining Effects

Alert Dashboard

Multi-Animal Team Mascot

Custom Box Style

Contributing

Code of Conduct

License

Project details

Verified details

Maintainers

Meta

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

File details

File metadata

File hashes

`typefx.writers`

`typefx.banners`

`typefx.effects`

`typefx.colors`

`typefx.styles`

`typefx.utility`