You are here

Cross-stitchify v2.1

  • 1
  • 2
  • 3
  • 4
  • 5
Total votes: 0
Rate this item!
cross-stitchify_v2_1.zip15.03 KB

Someone on an email list I belong to asked about ways of making a counted cross-stitch pattern from a photo. There are commercial packages that do this, but it seemed like something GIMP could do, and I wanted some Python practice.

Attached is a zip file containing the following files:

  • - Python script for converting a photo to a cross-stitch pattern
  • floss.html - an HTML document listing available cross-stitch floss colours by numbered index, common name, RGB and hex values (culled from

I used the Photoshop tutorial found here as my starting point. The script performs the following operations:

  • Pixellates, adjusts brightness & posterises according to user settings
  • Scales down the pixellated image to increase performance
  • Checks each colour of each mosaic tile, and performs "best matching" colour exchange against the palette of available floss colours
  • Scales up pixellated image for next operations and for readability
    vAdds grid in new layer
  • Adds text labels for each colour with floss' index number
  • Creates a text file listing all floss needed, and in what quantities

It appears in the menus under Filters > Decor > Cross-stitchify... It takes quite some time to run as I need to iterate through each tile of the image twice, and any interruption during the label phase can crash the script, but the output is quite good. The entire image can be printed for use as the pattern, or just the grid if printing in B&W.

UPDATE: version 2.0 - added creation of text file with list of what colour floss, and how many stitches of each, are used. Also allowed for greater range of mosaic sizes to accommodate wider range of images.
UPDATE: version 2.1 - added OS check: win32 opens text file, other OS displays message with path to file.

Code License: 
GIMP Version: 
Scripting Engine: 


Wow, it's been a while since I looked at this. can't promise I will be making any changes to this any time soon, but I like the ideas you present here.

My wife loves this - no other cross stitch app. for ubuntu gnome (there is a KDE app - kxstitch - but many problems compiling on gnome, so:
How about changing the floss colour number to show a symbol, anything from standard fonts would do - letters, etc., with a listing of symbol to floss number. This would be more like regular cross stitch applications and allow easier reading of final chart, and maybe allow smaller mosaic size without losing readability.
Also, one of the older posts here - being able to limit the palette size would make this really useable - haven't seen any further work on this - is it a possibility? I would love to but know absolutlely nothing about computers except as a "normal"user.


Subscribe to Comments for "Cross-stitchify v2.1"