Image to ASCII art
Open Image to ASCII art on Happytails.ai. This view has the same page content and links, with explicit tool capabilities. Read the processing notes before using a tool.
Tool capabilities
{
"id": "image-to-ascii-art",
"category": "image-tools",
"built": true,
"requirements": "Runs locally without uploads. One still PNG, JPEG or WebP up to 20 MiB and 16 million decoded pixels, with at most 16,384 pixels per side. Columns range from 1 to 400; character width to height ranges from 0.1 to 2. Output is limited to 400 rows and 160000 cells. Use 2 to 64 printable characters ordered from dark to light. Alpha is composited onto the chosen background, then each cell uses area-averaged brightness. The text, standalone HTML and report contain the full mosaic. Original metadata is not retained. Processing stops after 30 seconds.",
"implementation": {
"fields": [
{
"key": "columns",
"label": "Columns",
"value": "80",
"type": "number",
"min": 1,
"max": 400,
"step": 1
},
{
"key": "characterAspect",
"label": "Character width to height",
"value": "0.5",
"type": "number",
"min": 0.1,
"max": 2,
"step": 0.1
},
{
"key": "ramp",
"label": "Dark-to-light characters",
"value": "@%#*+=-:. ",
"type": "text"
},
{
"key": "invert",
"label": "Invert character ramp",
"value": false,
"type": "checkbox"
},
{
"key": "background",
"label": "Transparency background",
"value": "#ffffff",
"type": "color"
}
],
"registrationFamily": "pixel-editing",
"files": true,
"input": false,
"multiple": false,
"accept": ".png,.jpg,.jpeg,.webp",
"maxFileBytes": 20971520,
"deferImagePreview": true,
"note": "Runs locally without uploads. One still PNG, JPEG or WebP up to 20 MiB and 16 million decoded pixels, with at most 16,384 pixels per side. Columns range from 1 to 400; character width to height ranges from 0.1 to 2. Output is limited to 400 rows and 160000 cells. Use 2 to 64 printable characters ordered from dark to light. Alpha is composited onto the chosen background, then each cell uses area-averaged brightness. The text, standalone HTML and report contain the full mosaic. Original metadata is not retained. Processing stops after 30 seconds.",
"experience": {
"automatic": false,
"single": false,
"inputMaxLength": 1000000,
"inputMode": "text",
"label": "Your text",
"placeholder": "Type or paste your input…",
"help": "Up to 1,000,000 characters. Review the settings before running.",
"helpParts": [
"Up to 1,000,000 characters.",
"Review the settings before running."
],
"action": "Convert file"
},
"mode": "explicit",
"interactive": false
},
"execution": "Browser interface",
"api": null,
"browser_agent": {
"supported": true,
"name": "run_current_tool",
"discovery": "WebMCP on the human page in a supporting browser",
"verification": "See audit/API-AUDIT.md; availability is not verification"
}
}Page guide
Turn a photo into a character mosaic. Choose its width and characters, then copy or download the full result.
How to use Image to ASCII art
- Choose a still PNG, JPEG or WebP image.
- Set the output columns, character proportions and dark-to-light character ramp.
- Run the tool, review the mosaic, and download the text, standalone HTML or settings report.
Useful next steps
Match the character proportions
The width-to-height setting adjusts the number of rows for tall monospace characters. The default is 0.5. Change it if your chosen font stretches the image.
Choose a dark-to-light ramp
List denser characters first and lighter characters last. A space can represent white. Invert reverses the mapping. Transparent pixels are composited onto the chosen background before averaging.