Puzzle Solver

A jigsaw puzzle solver for the hard ones

That piece fits somewhere. Your phone knows where.

Scan your pieces one at a time on a printed card. Puzzle Solver traces each outline to a fraction of a millimetre, reads all four sides, and works out which pieces lock together. It's built for the hard ones: endless sky, swirling paint, hundreds of pieces that all look alike.

Sign in to start a puzzle

No app to install. Your photos never leave your phone. Open source on GitHub. (it stays in this browser only).

Welcome back. What are we solving today?

The Starry Night, Vincent van Gogh, 1889: widely considered one of the hardest jigsaw puzzles you can attempt. Shown on the outlines of 54 real pieces from our demo, placed where the solver put them.
1printed card, used for every piece
1piece at a time, numbered as you go
<1mmoutline detail, traced on your phone
0photos uploaded: only the outline is saved

How it works

Four steps, from pile to picture

No dumping the box on a scanner, no magic photo of the whole pile. You scan each piece on its own, so the app can measure it properly. It sounds slow, but it's what makes the matches trustworthy.

01

Print the scan card

Before your first scan, print our scan card page. It's one sheet with four 70 mm cards, each with a thick black frame. That frame is the scanner's ruler: it tells the app exactly how big each piece is and straightens out the camera angle, so every outline comes out true to size.

  • Print at 100% / actual size. A 50 mm check line on the sheet lets you confirm it.
  • Start with the magenta card; after each scan the app tells you if another card shows that piece more clearly.
  • The card is required. The scanner waits until it sees the frame.
๐Ÿ–จ Open the printable card
02

Scan one piece at a time

Put one piece face up in the middle of the card and hold your phone flat above it. A level shows how you're tilted. When the frame turns green and you hold still, the photo takes itself. The light switches on automatically where your phone allows it.

The outline is traced right on your phone at full camera resolution, with shadows filtered out. You get a preview to check before you move on.

  • Hold it flat, within 3ยฐ: the dot has to sit inside the small circle.
  • Get close, so the card fills the view. The app tells you if you're too far.
  • Prefer your camera app? Tap ๐Ÿ–ผ to shoot at full resolution with flash.
03

Number it, keep it

Each scan gets the next number: 1, 2, 3โ€ฆ Pencil it lightly on the back of the piece, or set the piece on a numbered sticky note or in an egg-carton slot. Later, when the app says "42 goes just left of 28", you'll know exactly which piece to grab.

  • Every piece is saved the moment you scan it, so you can stop and pick up later.
  • Typo? Labels can be edited, and a bad scan can be redone.
04

Match and solve

Open any piece to see its best partners for each side, ranked by how snugly they fit. Or tap Solve and the app assembles your catalog into groups: a map of numbered pieces, each in its place, ready for you to build from.

  • Every side is sorted as a tab, a blank or a flat edge, so corners and border pieces are found for you.
  • Scan on your phone, then open the solution on a bigger screen. With an account, your puzzles follow you.

What to expect

Honest expectations

Scanning is the slow part

It becomes a rhythm: place, hold, check, number, next. Budget an evening for a few hundred pieces and split big puzzles over several sessions. Solving takes seconds.

You don't have to scan everything

Only scanned pieces can be matched, so scan the part you're stuck on: all the sky, the border, one tricky colour. A few dozen pieces from the same area is plenty to start.

Shape is everything

Matching reads only the outline, never the picture. The swirls that make The Starry Night so hard by eye don't confuse it, and neither does a plain sky. It works best with grid-cut puzzles whose pieces differ in shape (Ravensburger-style). Cuts where many pieces look identical are harder.

Groups, not guesses

The solver is careful. It only joins pieces when every touching side agrees, so expect several solid groups rather than one risky answer. On a 500-piece reference set it put 489 pieces in one group, with 99.8% of neighbours right.

Your photos stay on your phone

The image is processed on your device and then thrown away. Only the outline, a list of points, and its number are saved.

Just a browser

Open this page on a recent phone with a camera. There's nothing to install. Allow camera access when asked, and you're scanning.

Under the hood

Why one piece at a time works

With a single piece on a known card, the app can afford to be precise. It corrects perspective with the card's frame and measures in real millimetres. It separates the piece from its shadow by colour rather than brightness, then traces the edge with sub-pixel accuracy.

The four corners split the outline into four sides. Each side is checked against every other side by fitting the two shapes together and measuring what's left over, allowing for the hairline gap real neighbours have. The solver then grows groups from the most certain matches and backs out a piece if its neighbours disagree.

It's all open source, with the details in the GitHub repository.

FAQ

Good questions

Do I need an account?

Not to look around: the demo works without one. Sign in with Cloudish to keep your catalog safe and open it on any device, for example scanning on your phone and browsing the solution on a laptop. You can also start without an account, but then the puzzle is only remembered by that browser.

Do I really have to print the card?

Yes. The black frame is how the scanner knows the true size of a piece and corrects for the camera angle. Without it, two photos of the same piece would differ and matching would suffer. One sheet is enough for a whole puzzle; if you don't have a printer, any copy shop or library can print it.

Why one piece at a time instead of a photo of the whole pile?

Precision. Matching depends on outlines being right to a fraction of a millimetre. One piece, centred on a known card and photographed flat at full resolution, gets there. A crowded table photo doesn't.

Which puzzles work best?

Classic grid-cut puzzles where each piece has four sides with tabs and blanks, and the shapes vary from piece to piece. Puzzles with many identical shapes, or irregular "random cut" pieces, are much harder because shape is all the app looks at. What's hard by eye is fine: night skies, oceans, paintings like The Starry Night. That's where the app helps most.

What if a scan comes out wrong?

You see every outline before you move on, so just scan it again. From the catalog you can also re-scan, relabel or delete any piece later.

Are my pictures uploaded anywhere?

No. Photos are processed on your phone and then discarded. The server only receives each piece's outline and label, and uses them to compute matches.

Is it open source?

Yes, under the MIT license. The scanner, the matcher and the solver are all on GitHub. Stars, issues and pull requests are welcome.

Clear the table. Grab a pencil. Let's find where it goes.

Don't forget to print the scan card first.