TraceGrid Puzzle Book Generator v1.3.0 is a Python desktop application for creating multi-page grid tracing puzzle books with live preview and print-ready export.
This repository contains the full source code, allowing you to customize grid generation, path logic, symbols, colors, layouts, and export workflows for personal, educational, or commercial publishing projects.

• 🧩 Multi-Puzzle Pages — Place multiple puzzles per page (rows × columns)
• 📐 Adjustable Grid Size — Control puzzle difficulty and density
• 🧭 Random Path Generation — Unique trace paths for every puzzle
• 🔀 Path Complexity Control — Adjust how long and challenging paths become
• 🔵 Symbol Types:
  • Dots
  • Circles
  • Squares
  • Mixed symbols
• 🎨 Full Color Customization:
  • Symbols
  • Lines
  • Background
• 📏 Line Thickness & Symbol Radius Controls
• 👀 Live Preview — Instantly see layout changes before exporting
• 📄 Automatic Multi-Page PDF Export — KDP-ready puzzle book output
• 🖼 Vector SVG Export — Commercial-quality scalable artwork
• 📦 Batch Page Generation — Create up to 100 pages at once
• 📐 Page Layout Control — Rows and columns per page
• 🎨 Modern Themed UI — Built with Tkinter + ttkbootstrap
• ℹ Built-In Info Panel — Instructions and feature overview included
• 🔒 Fully Offline:
  • No internet required
  • Local file generation only
• ⚡ Fast Rendering — Lightweight vector-based puzzle drawing
• 🧰 Portable Desktop Tool — Can be compiled into a standalone executable

1. Clone or download this repository:

git clone https://github.com/rogers-cyber/TraceGridPuzzleBook.git
cd TraceGridPuzzleBoo

2. Install required Python packages:

pip install pillow svgwrite reportlab cairosvg ttkbootstrap

(Tkinter is included with standard Python installations.)

3. Run the application:

python TraceGridPuzzleBook.py

4. Optional: Build a standalone executable using PyInstaller:

pyinstaller --onefile --windowed TraceGridPuzzleBook.py

1. Configure Puzzle Options:

   • Set Grid Size
   • Choose Symbol Type
   • Adjust Path Complexity
   • Customize Colors
   • Set Line Thickness and Symbol Radius

2. Configure Page Layout:

   • Choose Rows per Page
   • Choose Columns per Page
   • Set Number of Pages
   • Select Export Format

3. Live Preview:

   • Use the center preview panel to fine-tune your design in real time.

4. Select Output Folder:

   • Click 📂 Select Output Folder

5. Generate Puzzle Book:

   • Click 🖼 Generate Puzzle Book
   • SVG pages are created automatically
   • A combined PuzzleBook.pdf is generated for print

6. Info / Help:

   • Click ℹ Info for built-in instructions and feature explanations.

• page_001.svg, page_002.svg, … — Individual puzzle pages
• PuzzleBook.pdf — Combined multi-page printable puzzle book

All files are saved to your selected output directory.

• Python 3.10+
• Tkinter — Standard Python GUI framework
• ttkbootstrap — Modern themed UI
• Pillow — Image rendering and live preview
• svgwrite — Vector SVG generation
• reportlab — PDF assembly
• cairosvg — SVG → PNG conversion for PDF embedding
• pathlib, random, sys — Core application logic

• Each puzzle is generated procedurally for unlimited variations.
• Live preview regenerates puzzles dynamically as settings change.
• SVG output provides professional vector quality for commercial printing.
• Automatic PDF export combines all generated pages.
• Fully offline desktop workflow.
• Suitable for Amazon KDP interiors, Etsy printables, worksheets, and activity books.
• Easily extensible for new grid styles, symbols, or puzzle logic.
• Portable when compiled as a standalone executable.

TraceGrid Puzzle Book Generator v1.3.0 is maintained by Mate Technologies, delivering a fast, flexible, and offline puzzle book creation solution for authors, educators, and digital publishers.

Website: https://matetools.gumroad.com

Distributed as commercial source code.
You may use it for personal or commercial projects.
Redistribution, resale, or rebranding as a competing product is not allowed.