Metadata-Version: 2.4
Name: pyascii-maker
Version: 0.2.0
Summary: Advanced ASCII art generator with support for images, GIFs, videos, text banners, and multiple export formats
Author: Kevin
License-Expression: MIT
Project-URL: Homepage, https://github.com/discoveryos/pyascii-maker
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=9.0.0
Requires-Dist: pyfiglet>=0.8.post1
Provides-Extra: video
Requires-Dist: opencv-python-headless>=4.5.0; extra == "video"
Dynamic: license-file

# pyascii-maker

Advanced ASCII art generator with support for images, GIFs, videos, text banners, and multiple export formats.

## Installation

```bash
pip install pyascii-maker
```

With video support:

```bash
pip install pyascii-maker[video]
```

## Usage

### Basic image conversion

```bash
pyascii-maker image.jpg
```

### Animated shimmer

```bash
pyascii-maker image.jpg --animate
```

### Export formats

```bash
# HTML export
pyascii-maker image.jpg -o output.html

# Rendered image export
pyascii-maker image.jpg -o output.png --rendered

# With white background
pyascii-maker image.jpg --rendered -o out.jpg --bg white

# ASCII text file
pyascii-maker image.jpg -o output.txt
```

### Character sets

```bash
pyascii-maker image.jpg -c blocks
pyascii-maker image.jpg -c binary
pyascii-maker image.jpg -c matrix
pyascii-maker image.jpg --custom-chars "░▒▓█ "
```

### Text-only ASCII art

```bash
pyascii-maker --text "HELLO" -f doom
pyascii-maker --list-fonts
```

### Batch processing

```bash
pyascii-maker --folder ./images -o ./output
```

### GIF and video

```bash
pyascii-maker animation.gif
pyascii-maker video.mp4
```

### Advanced options

```bash
# RGB channel limiting
pyascii-maker image.jpg --rgb-cap 100,200,255

# Color enhancement
pyascii-maker image.jpg --saturation 2.0 --brightness 1.2

# Custom font for rendered images
pyascii-maker image.jpg --custom-font /path/to/font.ttf

# Add a banner
pyascii-maker image.jpg --label "DAISY" --theme cyan
```

## CLI Reference

| Option | Description | Default |
|--------|-------------|---------|
| `-w, --width` | Output width in characters | 80 |
| `-c, --char-set` | Character set style | standard |
| `--custom-chars` | Custom character string | - |
| `--contrast` | Contrast multiplier | 1.0 |
| `--brightness` | Brightness multiplier | 1.0 |
| `--saturation` | Saturation for rendered images | 1.0 |
| `--invert` | Invert brightness mapping | False |
| `--rgb-cap` | Cap RGB channels as R,G,B | - |
| `--char-size` | Font size for rendered image | 15 |
| `--char-width` | Pixel width per character | 10 |
| `--char-height` | Pixel height per character | 18 |
| `--scale-factor` | Downscale factor | 0.09 |
| `--custom-font` | Path to custom .ttf/.otf font | - |
| `--bg-color` | Background color (hex or name) | black |
| `--rendered` | Render ASCII as image file | False |
| `-o, --output` | Output file path | - |
| `--animate` | Animate with shimmer effect | False |
| `--label` | Add ASCII text banner | - |
| `--font, -f` | Pyfiglet font for banner | slant |
| `--theme` | Color theme for banners | cyan |
| `--folder` | Batch process folder | - |

## Supported Formats

- **Images**: jpg, jpeg, png, bmp, webp, tiff, tif
- **Animated**: gif
- **Video**: mp4, avi, mov, mkv, webm (requires opencv-python-headless)
- **Export**: txt, html, png, jpg, bmp

## License

MIT
