Back to Image
Image to ASCII art — render photos as text characters

Image to ASCII art — render photos as text characters

Convert JPEG / PNG / WebP images into ASCII art entirely in the browser. Map each pixel's luminance to a character ramp, tweak the output width, choose a charset (detailed / standard / simple / blocks), or invert the mapping — all with a live preview. Copy the result or download it as a .txt file. Your image never leaves the browser.

imageconversiontext

How to use

Drop or pick an image to upload it — ASCII art is generated automatically. Adjust 'Width (cols)' to control characters per line, switch the 'Character set' to change the ramp, or toggle 'Invert mapping' to swap how brightness maps to characters. Each control re-renders the preview live. Copy the result to your clipboard or download it as a .txt file. The image never leaves your browser; pixels are read with HTMLCanvasElement.getImageData locally.

FAQ

Is my image uploaded to a server?
No. Files are read locally with FileReader, decoded into a canvas, and inspected with getImageData. No network requests are made.
How do I pick the right character set?
'Detailed' (70 chars) gives the smoothest tonal range. 'Standard' (10 chars) is compact and reliable. 'Simple' (5 chars) is robust against rendering quirks. 'Blocks' uses Unicode block elements (▓▒░) for a pixel-art look in a monospace font.
When should I invert the mapping?
The default assumes black text on a white background (darker pixels get heavier characters). Flip the mapping when rendering on a dark background (in a terminal, for example) so brighter pixels show as solid characters.
What happens if I crank the width up?
Output gets wider with more characters per line, but the conversion stays fast (a few tens of ms even for 4K source images). Most editors / terminals wrap at 80–200 columns, so pick a width that suits your destination.
Which image formats are supported?
Any format your browser can natively decode — JPEG, PNG, and WebP. For HEIC photos from iPhone, convert them with the HEIC → JPEG tool first.
Is the aspect ratio preserved?
Yes. The conversion accounts for monospace characters being roughly twice as tall as they are wide, so the output keeps the source image's aspect ratio when rendered in a monospace font.

Related tools