PythonJigsaw01/README.md
serialexperiments0815 cc5b4e6232
Create README.md for PythonJigsaw01 project
Added a README file with project details, features, requirements, installation, and usage instructions.
2025-12-06 16:48:35 +01:00

1.1 KiB

PythonJigsaw01 🎯

A simple jigsaw puzzle game built with Python, PyQt5, and Pillow.
Load any image (below a certain size), split it into pieces, and manually assemble them - pieces snap together and cluster when placed near each other.


Features

  • Load a custom image and divide it into a configurable number of pieces.
  • Pieces are shuffled randomly on the canvas.
  • Drag and drop pieces with the mouse.
  • Pieces “snap” to neighbors when aligned - forming clusters that move together.
  • Settings persist via a JSON config (e.g., background color, puzzle size).
  • Supports different image & puzzle sizes (within reasonable limits).

Demo / Screenshots

Screenshot 2025-12-06 164542

Requirements


Installation

git clone https://github.com/serialexperiments0815/PythonJigsaw01.git
cd PythonJigsaw01
pip install PyQt5 Pillow

Usage

python main.py