ASCII Art

Convert any image to ASCII art with customizable charsets, colors, and animations.

Loading...

Installation

Run the following command

npx shadcn@latest add @aceternity/ascii-art

Examples

Matrix Animation

Loading...

Typewriter Animation

Loading...

Blocks Charset

Loading...

Binary Charset

Loading...

Dots Charset

Loading...

Braille Charset

Loading...

Dense Charset

Loading...

Circles Charset

Loading...

Stars Charset

Loading...

CSS Variable Colors

Loading...

Available Charsets

PresetCharacters
standardSpace, .,:;i1tfLCG08@
blocksSpace, ░▒▓█
binarySpace, 01
dotsSpace, ·•●
minimalSpace, .:░▒
denseExtended ASCII with many symbols
arrowsSpace, ←↑→↓↔↕↖↗↘↙
starsSpace, ·✦✧★
hashSpace, -=#
pipesSpace, pipe, slash, box-drawing chars
brailleSpace, ⠁⠃⠇⠏⠟⠿⡿⣿
circlesSpace, ○◔◑◕●
squaresSpace, ▢▣▤▥▦▧▨▩
heartsSpace, ♡♥
mathSpace, +-×÷=≠≈∞

Props

PropTypeDefaultDescriptionRequired
srcstring-Source image URL to convert to ASCII art.Yes
resolutionnumber80Number of ASCII columns (character resolution). Higher = more detail.No
charsetstring"standard"Charset preset name or custom character string.No
colorstring"#ffffff"Text color for ASCII art (ignored if colored=true). Supports CSS variables.No
backgroundColorstring"transparent"Background color. Supports CSS variables like var(--color-red-500).No
invertedbooleanfalseInvert the character mapping (dark becomes light).No
coloredbooleanfalseUse original image colors for each character.No
animatedbooleantrueEnable animation on load.No
animationStyle"fade" | "typewriter" | "matrix" | "none""fade"Animation style: fade in, typewriter reveal, matrix rain, or no animation.No
animationDurationnumber1Duration for fade animation in seconds.No
fontFamilystring"monospace"Font family for ASCII characters.No
classNamestringundefinedContainer className - use this to control size (e.g., w-full, h-64).No
animateOnViewbooleantrueOnly start animation when component enters viewport.No
objectFit"cover" | "contain" | "fill""cover"How the source image should fit within the ASCII grid.No

Build websites faster and 10x better than your competitors with

Aceternity UI Pro

Next.js 15, Tailwind CSS v4 and Motion for react powered templates

200+ templates and blocks combined

Ready to copy paste component blocks, save days of development time

Aceternity UI Pro Demo - Light Mode

Access an ever-growing collection of premium, meticulously crafted templates and Component Blocks.

A product by Aceternity
Building in public at @mannupaaji

© 2026 Aceternity Labs LLC. All Rights Reserved.