How to use Image to ASCII Art
Convert any photograph or graphic into ASCII art — a mosaic of text characters that recreates the image by mapping each sampled pixel's brightness to a character from a density ramp. Adjust the output width in characters, choose a character set (standard, dense, simple, or block elements), then copy the result or download it as a plain text file. All processing runs on a canvas in your browser.
- Upload your image using the file picker or drag-and-drop.
- Set the output width (number of characters per line) — 80–120 is typical for a terminal display.
- Choose a character set: Standard is a good starting point; Dense gives more tonal range.
- Click "Convert to ASCII" to generate the text art.
- Copy the ASCII art to your clipboard or download it as a .txt file.
Your data never leaves your device — 100% private processing.
How image-to-ASCII conversion works
The image is first drawn onto a small canvas scaled to the desired output width (columns) and a proportional height (rows), with an aspect correction of approximately 0.55 to compensate for the fact that terminal characters are roughly twice as tall as they are wide. For each cell in the resulting grid, the RGB values are read from the canvas's ImageData and converted to a single luminance value using the ITU-R BT.601 perceptual weighting formula: L = 0.299R + 0.587G + 0.114B, which weights green most heavily because human vision is most sensitive to green light. The luminance (0–255) is then linearly mapped to an index in the character ramp — 0 maps to the densest character (darkest), 255 maps to the lightest (a space).
Character ramp selection and output quality
The character ramp determines the tonal resolution of the output. The standard ramp "@#S%?*+;:,. " has 12 tonal levels — sufficient for most images. The dense ramp includes 70 characters and gives smooth gradients but requires a monospace font to render correctly. The simple ramp "@#+-. " produces a high-contrast, graphic look. Block elements (█▓▒░ ) work best in terminals and text editors that support Unicode block characters, and render a cleaner result than ASCII character ramps. Images with high contrast, clear subjects, and simple backgrounds produce the best ASCII art. Photorealistic images with many gradients work well with the dense ramp; logos and icons suit the simple ramp.
Glossary
- Luminance
- A measure of the perceived brightness of a pixel, calculated as a weighted average of its red, green, and blue channels.
- Character ramp
- An ordered sequence of characters from dense/dark (e.g. "@") to sparse/light (e.g. " "), used to represent different brightness levels.
- ITU-R BT.601
- A standard defining the perceptual luminance formula: L = 0.299R + 0.587G + 0.114B — used in image processing and video encoding.
- Aspect correction
- A scaling factor (~0.55) applied to the row count to compensate for terminal characters being taller than wide, preventing vertically stretched output.
Related reading
Frequently Asked Questions
Why use Image to ASCII Art?
- Character density ramp maps luminance levels to text for accurate tonal reproduction
- Adjustable output width in characters scales the result from terminal-width to wide-format
- Multiple character sets — standard, dense, simple, block — suit different display contexts
- One-click copy to clipboard lets you paste the art directly into a README or chat message
Common use cases
- Convert a headshot to ASCII art to embed as a creative header in a terminal README file
- Generate ASCII art from a company logo for inclusion in a CLI tool's welcome banner
- Create a text-art version of a photo as a novelty birthday message in a plain-text email
- Export a dense-ramp ASCII render of a landscape photo as a .txt file for a text-art project
- Produce a character-based preview of an image for a constrained low-bandwidth display
Get weekly tool tips & updates
New tools, power-user tips, and productivity hacks — delivered free every Friday.
No spam, ever. Unsubscribe with one click.
Related Image Tools
ASCII Art Generator
Turn text into big ASCII art banners with a built-in block-letter font. Copy the result for terminals, READMEs, and code comments. Free and private.
Image to Text (OCR)
Extract text from images and photos with OCR. Supports many languages, runs in your browser, and never uploads your files. Free and private.
Convert Image Format
Convert images between PNG, JPG, and WebP instantly. Free, private, and fast — everything runs in your browser and no files are ever uploaded.
EXIF Metadata Viewer & Remover
View EXIF metadata from photos — camera, date, GPS location — and download a clean copy with all metadata removed. Free, private EXIF tool in your browser.
PDF & Image OCR
Extract text from scanned PDFs and images online with OCR. Recognizes text in pictures and scanned documents right in your browser. Free and private.
Compress Image
Compress JPG, PNG, WebP images online. Reduce file size by up to 90% without visible quality loss. Free, private, runs in your browser.
Explore all Image Tools.