NumMaze v2.2.0 – Offline Arithmetic Puzzle Book Generator (Full Source Code)

NumMaze v2.2.0 is a Python desktop application for creating step-by-step solvable arithmetic puzzles with live preview and print-ready export.
This repository contains the full source code, allowing you to customize puzzle generation, difficulty, grid layouts, visual style, and export workflows for educational, personal, or commercial projects.

---

🌟 SCREENSHOT

---

🌟 FEATURES

• 🧩 Multi-Puzzle Pages — Generate multiple puzzles at once
• 📐 Adjustable Difficulty — Easy (4 numbers), Medium (6 numbers), Hard (9 numbers)
• 🔢 Grid Layouts:
  • 2×2 for Easy
  • 2×3 for Medium
  • 3×3 for Hard
• 🔀 Randomized Arithmetic Combinations — Unique puzzle each time
• 📝 Step-by-Step Solutions — Recursive solution logic shows every calculation
• 👀 Live Preview — Instantly see puzzle grid and solution
• 📄 Automatic Multi-Puzzle PDF Export — Combined or separate PDFs
• 🖼 High-Quality JPG Export — Separate or combined images
• 🎨 Dark-Themed Modern UI — Built with Tkinter + ttkbootstrap
• 🔒 Fully Offline:
  • No internet required
  • Local file generation only
• ⚡ Fast Rendering — Lightweight grid and number drawing
• 🧰 Portable Desktop Tool — Can be compiled into a standalone executable

---

🚀 INSTALLATION

1. Clone or download this repository:

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

2. Install required Python packages:

pip install pillow reportlab ttkbootstrap

(Tkinter is included with standard Python installations.)

3. Run the application:

python NumMaze.py

4. Optional: Build a standalone executable using PyInstaller:

pyinstaller --onefile --windowed NumMaze.py

---

💡 USAGE

1. Configure Puzzle Options:

   • Choose difficulty: Easy, Medium, Hard
   • Set the number of puzzles to generate

2. Preview Puzzle:

   • Click 🧩 Generate Single Puzzle to view one puzzle and solution

3. Export Options:

   • 📄 Multiple Puzzles (Combined PDF)
   • 📂 Multiple Puzzles (Separate PDFs)
   • 🖼 Multiple Puzzles (Separate JPGs)
   • 🖼 Multiple Puzzles (Combined JPG)

4. Clear Puzzle:

   • Click 🧹 Clear to reset the grid and solution

5. Info / About:

   • Click ℹ About for instructions and feature overview

---

⚙️ CONFIGURATION OPTIONS

Option	Description
Difficulty	Easy (4 numbers), Medium (6), Hard (9)
Number of Puzzles	Total puzzles to generate at once
Grid Layout	2×2, 2×3, 3×3 depending on difficulty
Target Number	Automatically calculated puzzle goal
Step-by-Step Solution	Shows arithmetic operations used
Export Format	PDF or JPG (separate or combined)
Output Folder	Destination for generated files
Live Preview	Real-time visual feedback on the grid and solution

---

📦 OUTPUT

• Puzzle_1.pdf, Puzzle_2.pdf, … — Individual puzzle PDFs
• Combined_Puzzles.pdf — Multi-puzzle PDF
• Puzzle_1.jpg, Puzzle_2.jpg, … — Individual puzzle images
• Combined_Puzzles.jpg — Single image containing all puzzles

All files are saved to your selected output directory.

---

📦 DEPENDENCIES

• Python 3.10+
• Tkinter — Standard Python GUI framework
• ttkbootstrap — Modern themed UI
• Pillow — Image rendering and JPG export
• reportlab — PDF creation and assembly
• pathlib, random, operator — Core application logic

---

📝 NOTES

• Each puzzle is generated procedurally for unlimited variations.
• Step-by-step solution is automatically created using recursive arithmetic logic.
• PDF and JPG exports support combined or separate puzzle outputs.
• Fully offline workflow, no internet connection required.
• Suitable for classrooms, homework worksheets, logic clubs, and math enrichment.
• Portable when compiled as a standalone executable.

---

👤 ABOUT

NumMaze v2.2.0 is maintained by Mate Technologies, delivering a fun, visual, and organized solution for arithmetic puzzle generation and printing.

Website: https://matetools.gumroad.com

---

📜 LICENSE

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.