Turning a photo into a usable cross-stitch pattern sounds simple: Resize the image Reduce the number of colors Draw a grid Export the result
But I quickly discovered that a visually recognizable image is not necessarily a practical pattern.
A usable cross-stitch chart also needs a manageable color palette, readable symbols, material estimates, sensible dimensions, and as few isolated “confetti” stitches as possible.
That challenge led me to build PhotoToPattern, a free browser-based tool that converts photos into printable cross-stitch patterns.
Users can upload a JPG, PNG, or WebP image and adjust: Stitch-grid width Maximum number of colors Fabric count Number of thread strands Brightness, contrast, and saturation Image crop Background removal Speckle-cleanup strength Included or excluded DMC colors
The generated result includes: A color preview A printable symbol chart DMC floss codes Stitch counts Estimated skein quantities Finished-size estimates Pattern difficulty and estimated stitching time PDF, PNG, and CSV exports
Photos can be personal, so uploading every image to a server felt unnecessary. The browser already provides the APIs needed to decode, resize, sample, and render images.
Because the conversion happens locally, the original image does not need to leave the user’s device.
A cross-stitch pattern cannot use arbitrary RGB values. Each color needs to correspond to thread that someone can actually buy.
Simple RGB distance produced some noticeably incorrect matches, especially around muted colors and similar shades. I switched to perceptual color comparison using LAB color space and CIEDE2000.
This is more computationally expensive than basic RGB distance, but it generally produces matches that are closer to how people perceive color differences.
Using too many colors makes a photo pattern expensive and difficult to stitch. Using too few can remove important details.
Instead of treating every pixel color equally, the palette reduction needs to preserve colors that: Cover significant areas Help separate the subject from the background Represent visually distinct regions Are important to the overall composition
The user can choose a maximum palette size and exclude specific DMC colors before rebuilding the chart.
This makes the result editable instead of presenting the first generated output as the final answer.
Photo conversions often create isolated pixels surrounded by unrelated colors. Stitchers commonly call these “confetti stitches.”
They may improve pixel-level similarity, but they make a physical project much more frustrating.
PhotoToPattern includes adjustable cleanup that replaces small isolated regions with suitable neighboring colors.