Photo Mosaic Generator
Build a photo mosaic — recreate a main image out of hundreds of small tile photos, with adjustable tile size, perceptual color matching, grout spacing, and high-resolution print export. 100% client-side; your photos never leave your browser.
About Photo Mosaic Generator
Build a photo mosaic — recreate a main image out of hundreds of small tile photos, with adjustable tile size, perceptual color matching, grout spacing, and high-resolution print export. 100% client-side; your photos never leave your browser. Everything runs locally in your browser — your data never leaves your device.
How to use
- Enter your input in the tool above.
- Adjust any options to your preference.
- Use the Copy or Download buttons to save the result.
- Everything happens locally — your data never leaves your browser.
FAQ
Do my photos get uploaded to a server?
No. Every step — tile indexing, color matching, and final compositing — runs locally in your browser using Web Workers, Canvas, and IndexedDB. Your main image and tile library never leave your device. This makes the tool safe for private family photos and commercial art installations alike.
How does the color matching work?
Each tile is downsampled to a small thumbnail and its average color is computed in both RGB and CIE Lab color spaces. When the mosaic is built, every cell of the main image is matched to the nearest tile using a k-d tree for fast nearest-neighbor search. You can choose average-color matching, perceptual Lab matching (better for human vision), or edge-aware matching which also weighs structural similarity.
How many tiles can I use, and will it freeze my browser?
Tiles are processed in a Web Worker pool sized to your CPU (capped at 8 workers). Hundreds of HEIC or large JPG tiles are downscaled aggressively and cached as ~48px thumbnails, keeping memory under ~256MB. A progress bar shows live status like 'Analyzing 800 photos…'. Even 1000+ tiles work on modest hardware.
Are HEIC photos from my iPhone supported?
Yes. When a HEIC file is detected, the heic2any library (~1.5MB) is lazy-loaded on demand and decodes the file to a bitmap inside a Worker. The library is only fetched when actually needed, keeping the initial bundle slim.
What if I don't have any tile photos?
Use the built-in starter tile set — a procedurally generated palette of solid colors and gradients that keeps the bundle small (no shipped image assets). It's perfect for testing the tool or creating abstract mosaics. You can also mix starter tiles with your own photos.
Can I export at print resolution?
Yes. Choose a target DPI and paper size (A4, A3, or Letter) and the tool calculates exact pixel dimensions, then renders the mosaic in 1024x1024 chunks streamed to a single full-resolution canvas. Export as PNG (lossless) or JPG (smaller). A CSV/JSON tile-map manifest is also available for recreating the mosaic offline as a physical installation.
Can I reuse my tile library across sessions?
Yes. Tile thumbnails and their precomputed average/Lab colors are persisted to IndexedDB. Next time you open the tool, you'll see 'Reusing N tiles from last session' and can start building immediately without re-indexing. You can clear the cache at any time.
What are the advanced features?
Side-by-side original/mosaic/blend comparison slider, per-tile inspection (click any tile to see its source photo, match score, and alternatives), a tile-usage histogram showing over/under-used tiles, custom tile weighting, a reveal-animation export (tiles flipping into place via MediaRecorder), a print-resolution calculator, and a mask-regions tool to mark important areas of the main image for best-match tiles.
Related tools
ASCII Art Generator
Convert images and text into ASCII art — image-to-ASCII with 5 dithering engines, text-to-ASCII with 60+ FIGlet fonts, plus webcam mode and TXT/PNG/SVG/HTML/ANSI/PDF export, all in your browser.
Barcode Generator
Generate scannable 1D/linear barcodes (Code128, EAN-13, UPC-A, ITF-14, GS1-128, Codabar, MSI, Pharmacode) with live preview, PNG/SVG/PDF export, bulk CSV batches, label sheets, and a camera scan-test — fully in-browser.
Bulk Image Renamer + Optimizer
Batch-rename and optimize many images in one pass with live preview, token templates, conflict auto-resolve, perceptual-hash dedupe, and a single ZIP download — 100% in your browser.