GPGF-tool2bin

Photo of a tool → Gridfinity bin STEP. Everything runs in your browser — photos never leave your device.

What goes over the network?

Downloads only, all of them the app itself: the page, its code, the vision and CAD engines, the blank template image the self-test checks, and the font for the revision label on the bin. After the first visit they’re cached and the app works offline.
Nothing is sent from your device. Opening a photo or STEP file just lets this page read it inside your browser; all processing happens on your computer, and the STEP you download is built right here. There is no server to receive anything — no account, no cookies, no analytics or tracking.
Your filename prefix, paper size and magnet size are kept in this browser only.
The files are hosted on GitHub Pages, which, like any web host, sees that the pages were requested (your IP address and browser) — never your photos or files.

1 · Grab a sheet of paper (template optional)

Any plain letter or A4 sheet works as the backdrop — no printing needed.
The printed template is worth it when: light is uneven or shadowed (“paper sheet not found”), the sheet blends into a white/light table, or you want the best accuracy — its marker border corrects perspective far better than four paper corners, and its 100 mm ruler verifies the print scale.
If you print it: 100% scale, tool goes in the gray field.

🖨 Letter template · 🖨 A4 template

2 · Scan a tool

📂 Open image (new) or STEP file (to revise)

Lay the tool on the sheet and photograph it with any camera (a phone is fine), then open the photo here — or drag it anywhere on this page.
An exported STEP goes in the same way: it reopens its design for revision, no photo needed.
Made a bin you like? Its settings (clearance, smoothness, finger scoops, wall, magnets, edge, …) stay for the next photo you open. With a tool already open, opening a STEP asks whether to revise that bin or use only its settings. Each tool keeps its own shape and thickness.
Shoot straight down over the tool.
Thick tool? Step back and use 2×/3× optical zoom if your camera has it — up close, it sees the tool’s sides and the outline comes out slightly oversized (sheet correction can’t fix that).
Even, diffuse light beats flash — flash puts glare on shiny tools. Use the flash only if it’s too dim.

Plain-paper size

sets the mm scale when you shoot on a plain sheet
ignored when the template is detected

fine detail (slower)

scans at 20 px/mm instead of 12 — roughly 3× slower
worth it for very snug fits (clearance near 0, smoothness low) or when the STEP goes somewhere finer than an FDM printer (resin, CNC)
for a normal printed bin the default already out-resolves the printer

name

part name — goes in the filename and the STEP’s part name
pre-filled from the photo’s filename

tool thickness mm

sets the pocket depth — measure the tool at its thickest
required before the scan starts
bin height rounds up in 7 mm Gridfinity units, always keeping a ≥7 mm floor under the pocket

3 · Pocket profile

max contour

pocket uses the tool’s convex hull — every notch, gap and concavity is bridged over, leaving one simple outline

guarantee clearance everywhere

the pocket is never closer to the tool than the clearance below, at every point — smoothing may only bow outward
off: smoothing can cut tight corners slightly closer (you’ll get a warning if it does)

flat faithful: keep all straight edges tight (automatic)

every straight tool edge keeps a straight pocket wall, snug to it (within ~0.3 mm) — no clicking
it does this by smoothing the whole outline a little less; corners still round per the smoothness setting
for one edge at a time, leave this off and use Straighten in the pocket preview instead

symmetric

mirrors the pocket across the tool’s symmetry axis — evens out lighting artifacts on symmetric tools
turn off for genuinely asymmetric ones

pocket depth

either way the pocket ends ≥7 mm above the bin’s bottom

clearance 1.0 mm

gap kept between the tool and the pocket wall — how loose the fit is

smoothness 8 mm

how much the outline is relaxed into a flowing curve — higher hides scan noise and small detail

finger scoop ⌀ 25 mm

finger scoops at the tool’s left and right ends so you can lift it out — 0 removes them
drag the lavender dots in the preview to reposition them

finger scoop fillet 6 mm

radius rounding the edge where a finger scoop meets the pocket wall

finger scoops

mirrored: both at the same height, dragging one moves the other
independent: drag each on its own; left / right only: one finger scoop

min wall 3.0 mm

thinnest allowed material between the pocket and the bin’s outside
the bin grows a 42 mm cell when the pocket would get too close

4 · Bin

filename prefix

in front of every exported filename
remembered on this device; clear it if you don’t want one

magnet pocket ⌀ × mm

pockets under all four corners of every 42 mm foot, with a 0.5 mm chamfered entry
these are the POCKET dimensions as cut — include your own press-fit allowance (e.g. a 6×2 mm magnet → 6.15 × 2.1)
limits keep the Gridfinity foot printable: ⌀ up to 6.8 mm, depth up to 3 mm (remembered on this device)

rev deboss

the revision (R01, R02, …) debossed 0.4 mm into the underside
reads when you flip the bin over

edge

1 mm chamfer on the rim and the pocket entry — easier tool drop-in
or sharp square edges

foot fit

looser (default): the whole foot 0.25 mm smaller per side — drops into baseplates more easily, and matches generators that add this clearance
standard: feet exactly to the Gridfinity profile
your choice is remembered on this device

build log

ⓘ

negative (name ends in NEG): the pocket cutout as its own solid — floor to rim, finger scoops included, no chamfer or magnets
same position as the bin, for your own cuts in CAD; download either one, or both

The STEP carries its own design: open or drop an exported .step back onto this page to revise it (no photo needed) — the next export uprevs itself (R01 → R02).

Engine self-test

CAD kernel (OpenCASCADE): loading…

Vision (OpenCV + ArUco): loading…

GPGF-tool2bin

1 · Grab a sheet of paper (template optional)

2 · Scan a tool

Detected outline

3 · Pocket profile

Pocket preview

4 · Bin

3D preview (drag to orbit · n = nearest ortho view)

Engine self-test