asciify-art
Convert images and videos to stunning ASCII and ANSI art right in your terminal!
asciify-art is a blazing fast command-line tool built in Python. Transform any image or video into beautiful text art with rich color support, various art styles, and incredibly optimized performance.
✨ Features
- Single Install: Everything is included—image and video processing works immediately.
- Multiple Styles: Choose from classic ASCII, detailed character palettes, braille patterns, matrix falling code, and more!
- True Color Support: Full 24-bit ANSI color formatting for foreground, background, or both.
- Video Playback: Super smooth and optimized video rendering directly in your terminal/console.
- Image Processing Filters: Tweak contrast, invert colors, or apply sharpen and edge enhance filters.
🚀 Installation
It's just one command away:
pip install asciify-art
Note: The CLI command remains asciify for convenience and speed!
📖 Quick Start
# Convert a simple image
asciify image photo.jpg
# Apply the "blocks" style with a colored background
asciify image photo.jpg -s blocks -c bg
# View all available art styles
asciify styles
🎨 Styles
| Style | Description | Best for |
|---|---|---|
ascii |
Classic .:-=+*#%@ |
Simple, clean output |
detailed |
70+ character palette | High-detail images |
blocks |
░▒▓█ shading |
Pixel-art aesthetic |
minimal |
Sparse .:oO0@ |
Clean, modern look |
braille |
Braille patterns | Dense, textured output |
matrix |
Katakana characters | Matrix effect |
dots |
Minimal dot art | Subtle conversions |
shade |
Circle progression ·∘○◎● |
Smooth gradients |
color |
True 24-bit ANSI | Full color output |
💡 Examples
Image Conversion
# Basic conversion
asciify image input.png
# Detailed style with foreground color
asciify image input.png -s detailed -c fg
# Custom width (80 characters) and high contrast
asciify image input.png -w 80 --contrast 1.5
# Save the output to a text file
asciify image input.png -o output.txt
Video Playback
# Play a video with default settings
asciify video clip.mp4
# Matrix style rendering at 15 FPS
asciify video clip.mp4 -s matrix -f 15
# Loop a video infinitely with a distinct colored background
asciify video clip.mp4 -c bg --loop
Color Modes
none- Plain text (default)fg- Colored foreground text charactersbg- Colored background cells (resembling pixel-art)both- Foreground + dimmed background combination
⚙️ Options
Image Command Options
| Option | Short | Description |
|---|---|---|
--style |
-s |
Art style (default: ascii) |
--color-mode |
-c |
Color mode: none/fg/bg/both |
--width |
-w |
Output width in characters |
--invert |
-i |
Invert brightness |
--contrast |
- | Contrast multiplier (default: 1.2) |
--sharpen |
- | Apply sharpen filter |
--edge |
- | Apply edge enhance |
--output |
-o |
Save to file |
Video Command Options
| Option | Short | Description |
|---|---|---|
--style |
-s |
Art style (default: ascii) |
--color-mode |
-c |
Color mode: none/fg/bg/both |
--width |
-w |
Output width in characters |
--fps |
-f |
Playback FPS |
--loop |
-l |
Loop video |
--invert |
-i |
Invert brightness |
--contrast |
- | Contrast multiplier (default: 1.2) |
❓ Help
Need more details? Access built-in documentation anytime:
asciify --help
asciify image --help
asciify video --help
📄 License
Distributed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for asciify-art 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| asciify_art-0.1.1.tar.gz | 48.1 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| asciify_art-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.1 MB
Release files / asciify_art-0.1.1.tar.gz
| Download URL | asciify_art-0.1.1.tar.gz |
|---|---|
| Size | 48.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c56137fa8d9ed71c600d73855c7b41c0f045fffb02a07059a63bb61d020daaf6
|
|
BLAKE2b-256 checksum How to use checksums |
42c33d4a5b94767782e0637351f7d113f9ebd7b4e8ac2908d75692ee55d857a3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Release files / asciify_art-0.1.1-py3-none-any.whl
| Download URL | asciify_art-0.1.1-py3-none-any.whl |
|---|---|
| Size | 10.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e7700b276d161ddfdd0833892274395ba2238ba4a1dbfc3132c059a88874ef84
|
|
BLAKE2b-256 checksum How to use checksums |
a1cfa28fe3410f8615162b009680f48ee1a947f55734fb2da42e95c0872eb5dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Security for asciify-art 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
