Skip to main content

Create jigsaw puzzle pieces from an image

Project description

A jigsaw puzzle pieces generator that levels the playing field.

This script may change a lot as I have yet to really use it for any active projects.

It basically creates jigsaw puzzle pieces in two formats: svg, and png. The number and size of pieces are set by passing the script different options. It takes a while to run if doing a lot of pieces. It currently uses potrace, and imagemagick convert subprocesses.



Python Packages:

Other Software needed:

If on ubuntu or other debian based distro:

$ apt-get install imagemagick potrace libffi-dev python-libxml2 libxml2-dev python-lxml

Install with pip in editable mode for developing and such:

$ pip install -e .


See the for more. Not everything has been implemented, but to create 100 randomly generated jigsaw puzzle pieces:

./bin/piecemaker --dir test  --number-of-pieces 100 test.jpg

Some in progress notes and such

These notes and such are probably outdated...

just clips - only create a clips svg file

clips - specify a clips svg file

compute adjacent - adds the adjacent piece id’s to each piece in JSON file.

minimum piece size - Will change the count of pieces to meet this requirement

max pixels - Will scale down the original image to meet this requirement

scaled sizes - output multiple scaled versions of piece pngs


clips svg file

adjacent.json - Lists each piece and their adjacent pieces


  full/ - unscaled version
    pieces.json - JSON file with pieces info
      directory with piece png files
  scaled-50/ - scaled 50% version (set by 'scaled sizes' option)
    pieces.json - JSON file with pieces info
      directory with piece png files

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for piecemaker, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size piecemaker-0.2.1.tar.gz (12.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page