Demo edition: exporting (SVG and PNG), saving project files and copying are turned off. Everything else in this manual works as described.
1. Introduction
JigsawGenie turns a size and a piece count into a ready-to-cut jigsaw puzzle file in seconds. It draws every cut line for you, lets you shape the puzzle and its tabs, and exports a true-scale SVG for laser cutters (Glowforge, xTool, LightBurn) and cutting machines (Cricut, Silhouette).
Quick start
- Under Puzzle size, enter the width and height, then the columns and rows (or type a Target pieces count and click Apply).
- Under Pieces & slots, pick a tab style from the strip of thumbnails.
- Click Shuffle until you like the layout.
- Optional: choose an Outline shape such as Heart or Star.
- Click Export SVG (top right) and open the file in your cutting software.
The file opens at its real size, with cut lines in red. The outer outline is cut last, so the board stays steady while the inside pieces are cut.
2. The workspace
The screen has five areas: the top bar, the toolbar on the left, the canvas in the middle, the status bar at the bottom and the settings panel on the right.
| Area | What it holds |
|---|---|
| Top bar | Project name (click to rename), New, Library, Open…, Save file, Undo, Redo, Export PNG, Export SVG |
| Toolbar (left) | Select, Pan, Edit corners & knots, Pencil, Bezier, Line, Rectangle, Ellipse, Polygon. The small letter on each button is its shortcut. |
| Canvas | The puzzle board. A white rectangle is the board; a dashed rectangle means an outline shape is in use. |
| Rulers | Top and left, in your chosen units. The white band marks the board. |
| Status bar | Zoom controls, cursor position, piece count and piece size |
| Settings panel (right) | Collapsible sections: Selected shape, Edit corners & knots, Puzzle size, Pieces & slots, Outline shape, Shape pieces, Image, Layers, Export |
Click a section title in the settings panel to fold or unfold it. Sections for a selected shape or for edit mode appear only when they apply.
Moving around the canvas
- Pan: scroll with the mouse wheel or two fingers, hold Space and drag, use the Pan tool (H), or drag empty canvas with the Select tool.
- Zoom: hold Ctrl or ⌘ while scrolling, or pinch on a trackpad. You can also use the − and + buttons or type a percentage.
- Fit to window: press 0, click Fit, or double-click empty canvas.
- Actual size: press 1 or click 1:1. At 100% the board is shown at its real-world size on a standard screen.
3. Setting up the puzzle
The Puzzle size section sets the board size and how many pieces it is divided into.
- Units: switch between mm and inches. This changes every size field and the rulers. Exported files always use real-world units, so they open at the right size either way.
- W and H: the board's width and height, from 10 mm to 5000 mm.
- Cols and Rows: the piece grid, 1 to 80 each. Pieces = cols × rows on a rectangle.
- Target pieces: type a number such as 500 and click Apply. JigsawGenie picks the columns and rows closest to that count with the squarest pieces for your board.
- Presets: common sizes from a 24-piece 150 × 100 mm board up to a 999-piece 27 × 20 in board.
- Min piece size: the smallest piece you want, in your chosen units; leave it at 0 to turn it off. Any piece smaller than this (by area, or a sliver thinner than half the minimum) is joined to the neighbour it shares the longest cut with. This mostly catches slivers where the grid meets a shaped outline, and tiny pieces from heavy corner jitter. A note under the field tells you how many pieces were merged, and warns you if your regular pieces are already below the minimum. Target pieces won't choose a grid finer than the minimum. Added slots you made by hand are never removed. It doesn't apply while “Each piece as its own closed path” is on.
The Export section's stats box shows the piece count, piece size, board size and total cut length. Cut length helps you estimate laser time.
Changing columns or rows starts a fresh grid. Any corners, knobs or slots you edited by hand (section 8) belong to the old grid and are not applied to the new one; Undo brings them back.
Grid styles
The five buttons at the top of Puzzle size set how the board is divided into pieces. Every style works with every outline shape, tab style and the hand-editing tools in section 8.
| Style | How pieces are laid out | Number field | Best with |
|---|---|---|---|
| Grid | Rows and columns, the classic layout | Cols and Rows | Any outline |
| Round | A centre piece with rings of pieces around it | Rings | Ellipse outline with W = H for a circle |
| Spiral | One strip of pieces winding out from the centre | Turns | Ellipse outline |
| Hexagon | A honeycomb of six-sided pieces | Cols and Rows | Any outline |
| Follow outline | Rings that run parallel to the outline at an even width, with long centre pieces cut into chunks | Rings | Heart, Star, Polygon or a Custom outline |
For Round, Spiral and Follow outline, the number of pieces in each ring is set automatically to keep pieces roughly square, so Cols is greyed out. Target pieces picks the number of rings for you. With Follow outline, pieces near sharp points and deep notches are smaller, since every ring has to pass through those narrow spots.
Switching grid style also starts a fresh set of hand edits; Undo brings the previous style and its edits back. “Each piece as its own closed path” in Export works only with the Grid style and a rectangle outline.
4. Pieces and slots
The Pieces & slots section controls the shape of every tab (also called a knob or slot) and how much the pieces vary.
Tab styles
Click a thumbnail for a quick choice, or use the drop-down for all styles. Your own imported or edited slots appear there too, marked “custom”.
| Style | Look | Good for |
|---|---|---|
| Classic | Traditional round knob on a narrow neck | Most puzzles |
| Round knob | Larger, fuller head | Small pieces, children's puzzles |
| Slim | Tall, narrow knob | Large pieces |
| Twin | One knob out and one in on the same edge | Harder puzzles |
| Wave | Gentle S-curve, no knob | Decorative pieces; does not lock |
| Dovetail | Straight-sided wedge | Wood and acrylic on a laser |
| T-key | T-shaped key | Thick material, strong lock |
| Arrow | Arrow head | Geometric designs |
| Square | Plain square tab | Simple designs; does not lock |
| Straight | No tab at all | Grid cut-outs, tiles |
| Random mix | Classic, Round, Slim and Twin mixed | Natural-looking puzzles |
Sliders
| Slider | What it does |
|---|---|
| Tab size | Overall tab size, relative to the piece size |
| ↔ Tab width | Stretches every tab along its edge (0.4× to 2×) |
| ↕ Tab height | Makes every tab stick out further or sit flatter (0.4× to 2×) |
| Size variation | How much tab sizes differ from one another |
| Tab position | How far tabs drift from the middle of their edge |
| Corner jitter | How irregular the piece corners are; 0 gives a perfect grid |
| Shape wobble | Gentle bending of each tab so no two look alike |
Direction, seed and shuffle
- Tab direction: Random points each tab in or out at random. Alternating gives a checkerboard pattern, as in many store-bought puzzles.
- Seed is the number behind the random layout. The same seed and settings always give the same puzzle, so note it down to recreate a design.
- Shuffle (or press S) picks a new seed for a fresh layout.
- Edit corners & knots… switches to hand-editing mode (section 8).
5. Outline shapes
The Outline shape section sets the outer edge of the puzzle. Pieces are cut to fit inside it.
- Rectangle: the classic board.
- Rounded: rectangle with rounded corners; set Corner radius.
- Ellipse: an oval or circle that fills the board.
- With the Round grid style, Center piece splits the middle piece into 2 (one cut across) or 4 (two cuts crossing at the center), each cut with a tab. In edit mode, the meeting point of the 4-way split can be dragged like any other corner.
- Heart: a heart that fills the board.
- Star: set the number of Points (3–12) and the Inner radius (how deep the points are).
- Polygon: set the number of Sides (3–12).
- Custom: any shape you supply, in one of three ways (below).
Each shape stretches to the board's width and height. For a perfect circle or an even star, make W and H equal.
Custom outlines
- Import SVG outline… — pick an SVG file. JigsawGenie uses the largest shape in it and sets the board height to keep its proportions.
- Trace image outline — import an image first (section 9), then click this. A PNG with a transparent background works best. For an image on a white background, move Trace threshold left if too much is included, or right if parts are missing. The image is lined up with the traced outline.
- Use as outline — draw a closed shape with the Polygon, Rectangle, Ellipse, Bezier or Pencil tool, select it, and click Use as outline in the Selected shape section. The board resizes to fit the shape.
At the edge: Keep tabs or Straighten
This setting decides what happens to tabs that would stick out past a shaped outline.
| Option | What happens | Choose it when |
|---|---|---|
| Keep tabs (default) | The tab is moved along its edge, flipped or shrunk until it fits inside. Lines are trimmed only where they meet the outline. | You want every border piece to lock into its neighbors |
| Straighten | Any edge that crosses the outline becomes a straight line | You prefer a plain look near the border |
With a shaped outline, the piece count in the stats is an estimate (shown with ≈).
6. Shape pieces
Shape pieces (sometimes called whimsies) are pieces in a shape you choose, such as a star, a flower, a circle or a heart, placed inside the puzzle. You can use as many as you like, and JigsawGenie cuts the rest of the puzzle around them.
Adding shape pieces
- Open Shape Pieces in the settings panel.
- Pick a shape: Circle, Star, Flower, Heart, or click Import SVG shape… to use your own. JigsawGenie uses the largest closed shape in the file, and adds it to the row of shapes so you can reuse it.
- Set the Size (the larger of its width and height), Rotation and Tabs on shape.
- Click Add one to place a single piece, or type a number in How many and click Scatter to place several at random spots that don't overlap.
Moving and changing them
- With the Select tool (V), drag a shape piece to move it. Hold Shift to move in a straight line, or use the arrow keys (Shift for 10 mm steps).
- Click a shape piece to select it. The panel then changes only that piece: its shape, size, rotation and tabs. Duplicate places a copy next to it, Delete (or the Delete key) removes it, and Done goes back to settings for new pieces.
- Remove all clears every shape piece. Undo brings them back.
How the puzzle is cut around them
- Grid lines inside a shape piece are removed, and the shape's outline becomes a cut line.
- A grid tab that would run into a shape piece is moved along its edge, flipped or made smaller. If none of those fit, that edge becomes a straight line.
- Thin slivers and small leftovers next to a shape piece are joined to a neighbouring piece, so nothing fragile is cut. The note under Min piece size says how many were joined. If you set a Min piece size, it is used everywhere instead.
- The piece count includes the shape pieces and updates as you add, move and remove them.
Tabs on shape
- Auto gives no tabs to shapes that already lock in place with their points or dents (star, flower, heart and similar), and 3 tabs to round shapes such as a circle.
- Set 1 to 8 tabs yourself if you prefer. Tabs go on the smoothest parts of the outline, away from where grid lines meet it. A tab that would run into a neighbouring cut is turned inward, and stretches that are too tightly curved get no tab.
Good to know
- Shape pieces work with every grid style and every outline shape. Keep them inside the outline.
- While you drag, the preview skips the sliver clean-up to stay quick; it is applied as soon as you let go.
- With Each piece as its own closed path on, adding shape pieces switches the export back to plain cut lines.
- Exported SVG files contain each shape piece as its own path (shape-piece-1, shape-piece-2…), in the cut color.
7. Slot template editor
The slot editor lets you design your own tab shape and use it across the whole puzzle. Open it with Edit slots… in Pieces & slots (⇧⌘T).
The window has three parts: the template list on the left, the editing grid in the middle, and settings with a live preview on the right. In the grid, the horizontal line is the piece edge and up is outward, into the neighboring piece.
Making a template
- Built-in templates are read-only. Select one and click Duplicate, or click New for a simple starting shape.
- Drag the blue points to reshape the tab.
- Double-click on the grid to add a point; it is placed on the nearest part of the line.
- Click a point and press Delete (or Remove selected point) to remove it.
- Rename it in the Name field.
- Click Use this template to apply it to the puzzle.
Custom templates save automatically and are kept between sessions.
Options
- Smooth curve: on, the line flows smoothly through the points; off, it runs in straight lines with sharp corners, which suits dovetails and keys.
- Mirror edits (symmetric): on, moving a point also moves its partner on the other side, so the tab stays symmetrical. Turn it off for one-sided shapes.
- Delete: removes a custom template. Any puzzle using it switches to Classic.
Importing an SVG as a slot
Click Import SVG shape… and pick a file. JigsawGenie uses the largest shape in it.
- An open path (a line with two loose ends): the two ends sit on the piece edge and the shape between them becomes the tab.
- A closed shape (a mushroom, star or logo): the shape is cut by a horizontal line and the part above the cut becomes the tab. Use Attach height to choose where the cut is, measured up from the bottom of the shape. A low value keeps a stem as the tab's neck.
Imported slots start with sharp corners and mirroring off. You can still edit their points, or tick Smooth curve to round them. Moving Attach height again redraws the tab from the original shape and replaces point edits.
8. Editing corners and knots by hand
Edit mode lets you reshape individual pieces after the puzzle is generated. Turn it on with the Edit corners & knots tool (K), or the button in Pieces & slots. Click Done or pick another tool to leave.
Three kinds of handle appear on the canvas:
| Handle | Marks | What you can do |
|---|---|---|
| Square | A piece corner | Drag to move it; the four edges around it follow |
| Orange circle | A tab (knob) | Drag anywhere to move the tab; double-click to flip it |
| Blue diamond | A bend point you added | Drag anywhere to bend the cut line |
Filled handles have been edited. On a large puzzle the handles stay hidden until you zoom in.
Corners
- Drag a square to move the corner. Corners on the outer edge of a rectangle slide only along that edge.
- Click a corner to type exact ΔX and ΔY offsets, or click Reset corner.
Knobs
Click a knob to show its settings:
- Position: where the tab sits along its edge.
- Size: scales the tab evenly. ↔ Width and ↕ Height stretch it on one axis (0.3× to 2.5×), on top of the puzzle-wide settings.
- Style: give just this tab a different shape, including your custom slots, or choose Straight to remove it.
- Flip direction (F, or double-click): makes the tab stick out of the other piece.
- Reset knot: puts the tab back and removes any bend points on that edge.
- Delete this slot (or the Delete key): removes the whole cut line, so the two pieces on either side become one. This works on any slot in the grid, not just ones you added.
Deleting and restoring slots
A deleted slot shows as a dashed orange line with a dashed circle in the middle. It is not cut or exported. To bring it back, click the dashed circle and click Restore this slot, or use Undo.
If Each piece as its own closed path is on, deleting a slot switches the export back to plain cut lines, so the joined pieces stay joined.
Bend points
- Double-click a cut line, Alt-click it, or click Add point and then click lines (Esc stops).
- Drag the blue diamond to bend the line.
- To remove a point, select it and press Delete or click Remove point.
Points can't go on the knob itself or right beside a corner; the app tells you if you try.
Adding a slot between two corners
Use this to split a piece in two, for example diagonally.
- Click the first corner, then Shift-click the second.
- Click Add slot between corners, or press Enter.
- A new cut with a knob appears. Edit it like any other knob.
To delete it, select its knob and press Delete or click Delete this slot. Corners that already share an edge can't be joined again.
The piece count in the status bar and Export stats updates as you add and delete slots.
Column widths and row heights
On the Grid style, each column and row can have its own size.
- In edit mode, a strip runs above the board (one block per column) and down its left side (one block per row), each labelled with its size.
- Drag a dark handle between two blocks to move that grid line. Only the two columns or rows beside it change.
- Click a block to select that column or row. Its area is highlighted, and the panel shows its Width or Height. Type a new size and the other columns or rows share the difference, so the board keeps its size.
- Equal columns / Equal rows evens out that direction again; Equal rows & columns evens out both.
- Tabs follow the size of the pieces beside each edge, so narrow pieces get smaller tabs.
- Corners and knobs you moved by hand keep their offsets when you resize columns or rows. Changing the number of columns or rows goes back to equal sizes.
- When custom sizes are in use, Puzzle size shows a note with a link to make them equal, and the piece size in the status bar is shown as an average.
Good to know
- Undo and Redo cover every hand edit. Reset all manual edits clears them all, including added slots.
- Hand edits stay when you shuffle, change tab size or change style. They are tied to the current grid, so changing rows or columns sets them aside.
- With a shaped outline, knobs you've edited stay where you put them. Only untouched knobs are moved automatically to fit.
9. Drawing, images and layers
Drawing tools add your own cut-outs or engraving on top of the puzzle, such as a name, a hole for a ribbon or a decorative border.
Drawing tools
| Tool | Key | How to draw |
|---|---|---|
| Pencil | P | Drag freehand. Finish near the start point to close the shape. |
| Bezier | B | Click points to make a smooth curve. Double-click or press Enter to finish; click the first point to close it. |
| Line | L | Drag from start to end. Hold Shift for 45° steps. |
| Rectangle | R | Drag corner to corner. Hold Shift for a square. |
| Ellipse | E | Drag across. Hold Shift for a circle. |
| Polygon | G | Click each corner. Click the first point or press Enter to close. |
Press Esc to cancel a shape you're drawing.
Working with shapes
With the Select tool (V), click a shape to select it.
- Move: drag it, or nudge with the arrow keys (Shift for 10 mm steps).
- Resize: drag a corner square. Hold Shift, or tick Lock proportions, to keep its shape.
- Rotate: drag the round handle above the shape. Hold Shift for 15° steps.
- Exact values: type X, Y, W, H and rotation in the Selected shape section.
- Line type: Cut (red in exports) or Engrave (blue in exports, shown blue on screen).
- Duplicate (⌘D or Ctrl+D), Delete (Delete key), or Use as outline (section 5).
Images
The Image section lets you place artwork on the board to preview the finished puzzle, trace its outline, or print it.
- Import image… adds a picture. Very large images are reduced to 3000 pixels on the longest side.
- Fit: Cover fills the board, Contain shows the whole image, Stretch distorts it to fit. “Traced / manual” keeps the position set by Trace image outline.
- Opacity fades the image so the cut lines stand out.
- Match puzzle to image aspect changes the board height to match the picture.
- The image is only exported if you tick Embed image in SVG (section 10), or when you export a PNG.
Layers
The Layers list has four layers: Puzzle cuts, Outline, Drawings and Image. Each shape you draw is listed under Drawings; click its name to select it.
- Eye icon: hides a layer. Hidden layers are left out of exports.
- Lock icon: freezes a layer. A locked Drawings layer can't be selected or drawn on. Locked Puzzle cuts, Outline or Image layers grey out their settings so they can't be changed by accident.
10. Saving and exporting
Your current design saves automatically as you work and reopens next time. For anything you want to keep, also save it to the Library or as a file.
Saving projects
| Option | Where it goes | Use it to |
|---|---|---|
| Library | Inside the app (web: this browser only) | Keep many designs with thumbnails; click a thumbnail to open one, or the bin icon to delete it |
| Save file | A .json file you download | Back up a design, move it to another computer, or share it |
| Open… | Reads a .json project file | Load a saved file; any custom slots it uses are added to your list |
| New | — | Start a blank puzzle; the old one stays in Undo history |
If an image is too large for the browser's storage, the Library saves the design without it and tells you. Save file always includes the image.
Exporting
- Export SVG: the cut file. It uses real millimetre units, so it opens at true size in LightBurn, xTool Creative Space, Glowforge, Cricut Design Space, Inkscape and Illustrator.
- Export PNG: a picture of the design including any image, at 150, 300 or 600 dpi. Use it for previews or printing.
- Copy SVG: puts the SVG code on the clipboard to paste into another program.
Export settings
| Setting | Default | Notes |
|---|---|---|
| Line width | 0.1 mm | A hairline; most laser software treats thin lines as cuts |
| Cut color | Red #FF0000 | Interior cuts, outline and cut-type drawings |
| Engrave color | Blue #0000FF | Engrave-type drawings |
| Each piece as its own closed path | Off | Rectangle outline only. Makes each piece a separate shape, for print-then-cut workflows. |
| Embed image in SVG | Off | Includes the artwork, clipped to the outline, for print-and-cut |
Laser tips
- In the SVG, cuts come first and the outline is last, so the board doesn't shift before the inner cuts are done. Keep this order in your laser software.
- Set your laser to treat the red layer as a cut and the blue layer as a score or engrave.
- Do a test cut on a small 2 × 2 piece puzzle to check how tightly the pieces fit. If they're too loose, increase Tab size slightly. If they're too tight, try a style with a wider neck, such as Round knob.
- Very small pieces in thick material can scorch or snap. Test-cut your smallest piece size in the actual material before a full run.
11. Menu Items, Shortcuts and troubleshooting
| Menu | Commands |
|---|---|
| File | New Puzzle ⌘N, Open Project ⌘O, Project Library ⌘L, Save Project File ⌘S, Export SVG ⌘E, Export PNG ⇧⌘E, Copy SVG ⌥⌘C |
| Edit | Undo ⌘Z, Redo ⇧⌘Z, Cut, Copy, Paste, Select All, Duplicate Shape ⌘D, Shuffle Layout, Slot Template Editor ⇧⌘T |
| Tools | Every canvas tool, with its single-letter shortcut shown |
| View | Zoom In ⌘=, Zoom Out ⌘−, Fit to Window ⌘0, Actual Size ⌘1, Enter Full Screen ⌃⌘F |
| Help | Welcome & Shortcuts |
Keyboard shortcuts
| Keys | Action |
|---|---|
| V · H · K | Select · Pan · Edit corners & knots |
| P · B · L · R · E · G | Pencil · Bezier · Line · Rectangle · Ellipse · Polygon |
| S | Shuffle layout (new seed) |
| 0 · 1 | Fit to window · Actual size |
| + · − | Zoom in · Zoom out |
| Space + drag | Pan |
| ⌘ + scroll, or pinch | Zoom at the pointer |
| ⌘Z · ⇧⌘Z (or ⌘Y) | Undo · Redo |
| ⌘S | Save project file |
| ⌘D | Duplicate selected shape |
| Delete | Delete the selected shape, point or slot; reset a selected corner |
| Arrow keys (Shift: ×10) | Nudge the selected shape by 1 mm (10 mm) |
| Shift while drawing | Square, circle, or 45° line |
| Enter | Finish a Bezier or Polygon; add a slot between two selected corners |
| Esc | Cancel drawing, stop adding points, deselect, close a dialog |
| F | Flip the selected knob (edit mode) |
| Alt + click a cut line | Add a bend point (edit mode) |
| Shift + click a corner | Select a second corner (edit mode) |
Troubleshooting
| Problem | Fix |
|---|---|
| Export SVG does nothing in the browser | Accept the save prompt if one appears. If downloads are blocked, use Copy SVG and paste into your software, or use the Mac app. |
| The file opens at the wrong size | Make sure your software imports SVGs in mm, or at 96 dpi. JigsawGenie writes sizes in millimetres. |
| Lines are engraved instead of cut | Map the red colour to a cut operation in your laser software, or raise Line width if it ignores hairlines. |
| Corner and knob handles don't appear | Zoom in; they're hidden when pieces are small on screen. Also check that the Puzzle cuts layer isn't locked. |
| My hand edits disappeared | You changed rows or columns. Undo brings them back. |
| Trace image outline finds the wrong shape | Use a PNG with a transparent background, or adjust Trace threshold. Only the largest solid area is traced. |
| Imported SVG outline or slot looks wrong | JigsawGenie uses only the largest shape in the file. Delete other shapes, or convert text to paths, before importing. |
| A drawing tool won't draw | The Drawings layer is locked. Unlock it in Layers. |
| The settings panel is greyed out | That layer is locked. Click its lock icon in Layers. |
| My library is empty on another computer | The library is stored per browser or per Mac. Move designs with Save file and Open…. |