Textfx

Python

Textfx is a lightweight Python library for creating dynamic, visually engaging console text effects and Loading Animation.

Installation

pip install textfx

Or clone & install dependencies:

git clone https://github.com/iliakarimi/textfx.git
cd textfx
pip install -r requirements.txt

Features

Typing Effect
Scramble Effect
Wave Text
Untyping Effect
Unscramble Effect
Unwave Text
Loading Animations
Color Support via termcolor

Usage

Import the desired effects and loaders:

from textfx import (
    typeeffect, scrameffect, wavetext,
    untypeeffect, unscrameffect, unwavetext,
    SpinnerLoading, ProgressBarLoading, GlitchLoading
)

Loading Animations

All loader classes share these parameters:

message (str): Prefix text displayed before the animation.
end_message (str): Text displayed after the loader stops.
delay (float): Seconds between animation frames.

1. SpinnerLoading

Classic spinner cursor:

with SpinnerLoading(
    message="Processing...",
    animation="â ‹â ™â ¸â ´â ¦â ‡",
    delay=0.1
):
    do_work()

2. ProgressBarLoading

Animated bar moving back and forth:

with ProgressBarLoading(
    barline='-', animation='â–ˆ', length=30,
    message="Loading", delay=0.05
):
    do_work()

3. GlitchLoading

Random-character glitch effect:

with ProgressBarLoading(message="Compiling Code", barline=".", animation="âš™", length=40, message_color="cyan", animation_color="yellow", barline_color="white", delay=0.07):
    time.sleep(5)

For detailed examples, see Documention.

Color Options

All effects support an optional color parameter (via termcolor):

black red green yellow blue magenta cyan white

light_grey dark_grey light_red light_green light_yellow light_blue light_magenta light_cyan

Ensure your terminal supports ANSI colors for termcolor outputs.

Dependencies

Python 3.9+
termcolor

Install dependencies:

pip install -r requirements.txt

Contributing

Pull requests are welcome! For more examples and details, refer to docs/examples.md.

License

MIT License ... see LICENSE.

Enjoy using Textfx!

Release files for textfx 2.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for textfx 2.4.4
File	Size	Uploaded
textfx-2.4.4.tar.gz	7.7 kB	Nov 25, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for textfx 2.4.4
File	Interpreter	ABI	Platform	Reset
textfx-2.4.4-py3-none-any.whl 7.1 kB Nov 25, 2025	Python 3	none	any	Details

Total release size: 14.8 kB

Release files / textfx-2.4.4.tar.gz

Download URL	textfx-2.4.4.tar.gz
Size	7.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`fd520145cf3dafacdfc4546632fadc56c780e66a90fb9e2de200a3a6109ad8b3`
BLAKE2b-256 checksum How to use checksums	`68cc1445411cedb4c39df477ac3e22cf45f4e057f452937822fe528fdd500630`
Upload date	Nov 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.9`

Release files / textfx-2.4.4-py3-none-any.whl

Download URL	textfx-2.4.4-py3-none-any.whl
Size	7.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8b7ba3f404456e1b5b51a123561523eee21bb8edeb664397569e8d74b096e5d1`
BLAKE2b-256 checksum How to use checksums	`93b43e0f310f9e614c847fd95720b8bf0108d51a812eca00219213628f49e608`
Upload date	Nov 25, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.9`