GridArt is a local desktop tool that converts images into printable grid patterns for Perler beads, fuse beads, cross-stitch, diamond painting, and pixel art projects.
It uses KMeans color quantization to simplify an image into a configurable bead palette, then exports a detailed pattern as a PDF or high-resolution PNG. The application runs locally and does not upload images to an external service.
- Convert PNG, JPG, BMP, WEBP, and GIF images into grid-based craft patterns
- Choose preset or custom grid sizes from 10 to 200 cells
- Reduce images to 2–64 colors with automatic color names and bead counts
- Preview patterns with zoom, grid lines, row numbers, and column numbers
- Export printable multi-page PDF charts with color legends
- Export high-resolution PNG charts with symbols in each cell
- Built with Python, PyQt5, Pillow, NumPy, scikit-learn, and ReportLab
Download and run dist/GridArt.exe. No Python installation is required for the packaged release.
python -m venv .venv
.venv\\Scripts\\activate
pip install -r requirements.txt
python main.py- Import an image.
- Select the pattern grid size.
- Adjust the number of colors.
- Review the bead palette and counts.
- Export a PDF or PNG pattern for making and printing.
For detailed Chinese instructions, see USAGE.md.
GridArt is useful for DIY bead art, Perler bead templates, fuse bead patterns, pixel art charts, cross-stitch planning, diamond painting references, and other image-to-grid craft workflows.
v1.0