# ctxzz Profile Card

🚀 Atsushi Omata / ctxzz's animated terminal profile card generator with stunning visual effects!

## Quick Start

```bash
uvx ctxzz
```

## Features

- 🎨 **23 stunning visual effects** powered by [terminaltexteffects](https://github.com/ChrisBuilds/terminaltexteffects)
- ⚡ **Zero configuration** - works out of the box
- 🎲 **Random effects** by default for surprise and delight
- 🎯 **Specific effect selection** for your preferred style
- 💫 **Beautiful profile design** with clean, modern layout

## Installation

### Using uvx (Recommended)
```bash
uvx ctxzz
```

### Using pip
```bash
pip install ctxzz
ctxzz
```

### Using uv
```bash
uv tool install ctxzz
ctxzz
```

## Usage

```bash
# Random effect (default)
uvx ctxzz

# Core effects
uvx ctxzz matrix      # Matrix-style digital rain
uvx ctxzz decrypt     # Decryption cipher effect
uvx ctxzz fireworks   # Colorful fireworks explosion
uvx ctxzz waves       # Smooth wave animation
uvx ctxzz print       # Typewriter-style printing
uvx ctxzz slide       # Sliding text animation

# Extended effects
uvx ctxzz beams       # Light beam effects
uvx ctxzz bubbles     # Floating bubbles
uvx ctxzz burn        # Fire burning effect
uvx ctxzz crumble     # Crumbling text
uvx ctxzz scattered   # Scattered animation
uvx ctxzz spotlights  # Spotlight illumination
uvx ctxzz vhstape     # Retro VHS glitch
```

## All Available Effects

### 🌟 Core Effects
- **matrix** - Matrix-style green digital rain
- **decrypt** - Colorful decryption cipher effect
- **fireworks** - Explosive colorful fireworks
- **waves** - Smooth flowing wave animation
- **slide** - Text sliding into position
- **rain** - Gentle rain effect
- **print** - Classic typewriter printing
- **wipe** - Screen wipe transition
- **beams** - Dynamic light beam effects
- **bouncyballs** - Bouncing colorful balls
- **bubbles** - Floating soap bubbles
- **burn** - Realistic fire burning
- **crumble** - Text crumbling apart
- **errorcorrect** - Error correction simulation
- **laseretch** - Laser etching effect
- **overflow** - Data overflow visualization
- **scattered** - Randomly scattered elements
- **spotlights** - Moving spotlights
- **sweep** - Sweeping motion effect
- **vhstape** - Retro VHS tape glitch

### 🎯 Utility
- **simple** - Clean, instant display
- **typewriter** - Custom typewriter implementation
- **random** - Randomly selected effect
- **help** - Show all available effects

## Requirements

- Python 3.8+
- terminaltexteffects 0.12.0+

## Development

```bash
# Clone and setup
git clone https://github.com/ctxzz/ctxzz-profile-card
cd ctxzz-profile-card

# Using uv (recommended)
uv sync
uv run ctxzz

# Or using pip
pip install -e .
ctxzz
```

## License

MIT License - feel free to customize and make it your own!


## Credits

This project is powered by the amazing [terminaltexteffects](https://github.com/ChrisBuilds/terminaltexteffects) library by [@ChrisBuilds](https://github.com/ChrisBuilds). Check out the [full showroom](https://chrisbuilds.github.io/terminaltexteffects/showroom/) to see all the incredible effects in action!