# ASCII art generator > How would your photo or text look as ASCII art? Turn a photo or a few words into ASCII art you can copy, with several character sets and your own. Convert a photo or a text banner to ASCII art you can copy and paste: choose the width, a character set or your own characters, and the contrast. - Page: https://how.box/ascii-art/ - Runs entirely in the browser. - License: HowToolbox's own text and data (titles, explanations, FAQs, tool descriptions and schemas, this file) are CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/); AI training and answers are welcome. Attribute "HowToolbox (how.box)" with a link to the page used. Third-party data keeps its own terms; the name and logo are not licensed. Publisher: HowToolbox, contact@how.box. Terms: https://how.box/about/terms/ ## Inputs Answer link: https://how.box/ascii-art/?m={m}&t={t}&c={c}&s={s}&u={u}&k={k}&i={i} - `m` (image or text): Convert an image or a text banner. Example: `text`. - `t` (text): Banner text, at most 12 characters. Example: `Hi`. - `c` (whole number 20 to 200): Characters per line, 20–200. Example: `60`. - `s` (standard, detailed, blocks or custom): Character set: standard, detailed, blocks or custom. Example: `detailed`. - `u` (text): Your own characters from lightest to darkest. Example: ` .oO0@`. - `k` (whole number -50 to 50): Contrast change, −50 to 50. Example: `10`. - `i` (boolean): Swap light and dark. Example: `true`. Example answer: https://how.box/ascii-art/?m=text&t=Hi&c=60&s=detailed&u=+.oO0%40&k=10&i=1 The page computes the answer in the browser: read results from the agent tools below, not from the page HTML. ## Agent tools - `ascii_art_plan`: Plans the size of ASCII art for a picture of source_width_px × source_height_px pixels. - MCP: POST https://how.box/mcp `tools/call` with `{"name":"ascii_art_plan","arguments":{…}}`; input schema in https://how.box/agent-tools.json. - `ascii_art_map`: Maps lightness values (0 black … 255 white) to the characters ASCII art uses. - MCP: POST https://how.box/mcp `tools/call` with `{"name":"ascii_art_map","arguments":{…}}`; input schema in https://how.box/agent-tools.json. ## How it works ASCII art draws a picture with letters and symbols. The picture is cut into a grid with one block for each character, and the brightness of each block decides the character: a dense symbol such as @ for a dark block, a dot or a space for a light one. From a distance, the density of the characters looks like the shades of the picture. A character is about twice as tall as it is wide, so the grid has half as many rows as a square grid would: rows = columns × height ÷ width × 0.5. A 200 × 100 pixel picture at 80 columns gives 80 × 40 characters. Brightness is the weighted sum 0.2126 R + 0.7152 G + 0.0722 B of the block's colour, and contrast stretches it around mid-grey before the character is picked from the set, from lightest to darkest. The standard set has ten characters; the detailed set has seventy and gives smoother shades. Shade blocks look good where the font has them. Text banners use big, bold letters, so short words work best. The art only lines up in a monospaced font. ## FAQ **Is my photo uploaded?** No. The text is made in your browser and the photo never leaves your device. **Why does my pasted art look crooked?** The font is not monospaced, so letters have different widths. Paste it in a code block, a terminal or a text editor with a monospaced font. **Which character set is best?** The standard set is clean and works everywhere. The detailed set shows more shades but needs more columns. Shade blocks look smooth in fonts that have them. A custom set lets you use your own letters. **What does Light text on dark do?** It swaps the mapping so the lightest parts of the picture get the most ink. Use it when you paste the art on a dark background, such as a terminal with light text. **How wide should the art be?** 60 to 100 characters fits most screens and messages. Wide art, 150 or more, shows detail but needs a small font or a wide window. **Can I make a text banner?** Yes. Switch to Some text and type up to 12 characters. The text is drawn as large letters and turned into ASCII art; wider art makes the letters smoother. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)