# String art generator > How would your photo look as string art? Turn a photo into one thread wound between nails: see it draw, then print the nail template and the thread order. Make string art from a photo: choose the nails and threads, watch the thread picture draw, then print the nail template at real size and the thread order. - Page: https://how.box/string-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/string-art/?n={n}&t={t}&f={f}&s={s}&p={p}&o={o} - `n` (whole number 100 to 300): Number of nails, 100–300. Example: `250`. - `t` (whole number 500 to 4000): Most threads to wind, 500–4000. Example: `3000`. - `f` (circle or square): Frame shape: circle or square. Example: `square`. - `s` (whole number 20 to 100): Frame size in centimetres. Example: `50`. - `p` (a4 or letter): Paper: a4 or letter. Example: `a4`. - `o` (portrait or landscape): Page orientation: portrait or landscape. Example: `portrait`. Example answer: https://how.box/string-art/?n=250&t=3000&f=square&s=50&p=a4&o=portrait The page computes the answer in the browser: read results from the agent tools below, not from the page HTML. ## Agent tools - `string_art_plan`: Plans the frame of a string-art picture: `nails` (100–300) equally spaced around a `circle` of `size_cm` diameter or a `square` of `size_cm` side (20–100), wound with up to `threads` threads (500–4000). - MCP, one POST to https://how.box/mcp: `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"string_art_plan","arguments":{"nails":250,"threads":3000,"frame":"square","size_cm":50,"paper":"a4","orientation":"portrait"}}}` - GET: https://how.box/mcp/run/string_art_plan?nails=250&threads=3000&frame=square&size_cm=50&paper=a4&orientation=portrait ## How it works String art draws a picture with one long thread. Nails stand around a frame, and the thread goes from nail to nail in straight lines. Where many lines cross, the picture is dark; where few cross, it stays light. The tool works out which nail to go to next, one thread at a time. It uses a greedy method. The picture's darkness is what is left to cover. From the nail the thread is at, the tool looks at the straight line to every other nail and picks the one that crosses the most darkness on average; then it lowers the darkness along that line, because a thread covers part of what lies under it, and repeats. A line is used at most twice, and nails right next to each other are skipped. The frame size gives the real length: a thread between two nails is a chord of the frame, and for a circle the average chord is 4 × radius ÷ π, about 1.27 times the radius. A 40 cm circle with 2 000 threads takes roughly 500 metres. The result is an approximation of the photo; faces and bold shapes work best, fine detail does not. ## FAQ **Is my photo uploaded?** No. The thread path is worked out in your browser and the photo never leaves your device. **How many nails and threads should I use?** About 200 nails and 2 000 threads suit a 40 cm frame. More nails make smoother lines, more threads make the picture darker and more detailed, and they also take longer to wind. **What thread and board work best?** Dark thread on a light board, or white thread on a black board for a glowing look. Use thin, non-stretchy thread and small nails with a flat head, pushed in evenly. **How do I follow the thread order?** Start at nail 1 and go to the next nail in the list, always keeping the thread taut and wrapping it once around the nail before the next line. Use the step-through view to see the next line on the picture. **How do I place the nails exactly?** Print the template at 100 %, join the sheets at the corner crosses and push each nail through a cross into the board. The nails are numbered clockwise from the top. **Why did it stop before the number of threads I set?** When no line is left that crosses a dark area, more threads would only add noise, so the tool stops. A light picture needs fewer threads. More: [HowToolbox index](https://how.box/llms.txt) · [Agent Skill](https://how.box/skill.md) · [agent terms](https://how.box/about/agents/)