happytails.ai

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
  1. Choose a still PNG, JPEG or WebP image.
  2. Set the output columns, character proportions and dark-to-light character ramp.
  3. 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.