← Zur Startseite

Passmio – Handbuch

Passmio macht aus einem Foto deiner Werkzeuge eine passgenaue Einlage: für den 3D-Druck (Gridfinity oder flache Einlage) oder für Schaumstoff (Laser, CNC, Handschnitt). Alles läuft lokal im Browser, dein Foto verlässt den Rechner nicht.

1. Schnellstart in 5 Minuten

  1. Foto: Werkzeuge flach auf ein weißes oder farbiges A4-Blatt legen, von oben fotografieren, möglichst weit weg und mit Zoom.
  2. Papier: Die vier Papierecken prüfen, Papierformat wählen. Dann „Weiter: Werkzeuge erkennen".
  3. Erfassen: Konturen prüfen. Fehlendes mit „+ Neu per Klick" ergänzen. Echte Länge des längsten Werkzeugs eintragen. „Weiter: Design".
  4. Individualisieren & Export: Typ wählen (Gridfinity, Flache Einlage, Schaumstoff), Spiel einstellen, Werkzeuge anordnen, exportieren.
  5. Vor dem Druck: „Größen-Check PDF" mit 100 % drucken und echte Werkzeuge auf die Umrisse legen.

Dein Projekt wird automatisch gespeichert und ist in der 📚 Bibliothek wieder da.

2. Starten und aktualisieren (Mac)

cd ~/Downloads/passmio
npm run dev -- --force

Dann http://localhost:5173 in Safari öffnen. Nach jedem Update Safari mit Cmd+Shift+R neu laden.

KI-Modelle (einmalig): npm run setup lädt die Erkennungsmodelle (ca. 180 MB Freisteller, dazu SAM). Ohne sie nutzt Passmio nur das einfachere SAM und die Konturen werden ungenauer, besonders an Backen, Maulenden und glänzenden Teilen. Die Modelle liegen lokal in public/models bzw. ~/.werkzeugschatten und gehören nicht in Git.

3. Schritt 1 – Foto hochladen

Gutes Foto

Papierformat

Das häufigste Problem sind falsche Größen durch ein falsch gewähltes Format. Prüfe unter „Papier", ob A4 oder Letter eingestellt ist, und ob die vier Ecken wirklich auf den Papierecken sitzen.

Marker-Blatt (genauer ohne weißes Papier)

„Marker-Blatt (PDF) laden", in 100 % drucken, Werkzeuge in die Mitte legen, Foto hochladen. Die vier Quadrate werden automatisch erkannt.

Perspektivkorrektur (hohe Werkzeuge)

Hohe Werkzeuge wirken im Foto größer als sie sind. Die Option „Perspektivkorrektur" gleicht das aus. Dafür braucht Passmio die Höhe des Werkzeugs („Standard-Werkzeughöhe", je Werkzeug änderbar). Der Foto-Check zeigt dir, wie groß der Restfehler noch sein kann.

4. Schritt 2 – Erfassen

Erkennung

Im Schritt „Werkzeuge" wählst du unter „KI-Erkennung" die Erkennungsart:

„Werkzeugarten bestimmen (Höhe, Name)" lässt die KI jedem Werkzeug Name und typische Höhe geben, das verbessert die Perspektivkorrektur.

Konturen verfeinern

Echte Maße

Miss das längste Werkzeug mit dem Messschieber nach und trage die echte Länge ein. Passmio rechnet die Kontur auf dieses Maß. Mit „Höhe aus Messung ableiten (empfohlen)" berechnet Passmio daraus zusätzlich die Werkzeughöhe für die Perspektivkorrektur. „↺ Echtmaße entfernen" nimmt es zurück.

Ausrichten und Symmetrie

Spiegeln (Werkzeug umdrehen)

Soll die Tasche für die andere Seite des Werkzeugs gelten (Werkzeug umdrehen), schaltest du im Eigenschaften-Fenster „Spiegeln (Werkzeug umdrehen)" ein. Die Tasche wird gespiegelt, Fläche und Größe bleiben gleich. Für Formen (Kreis, Text, Nüsse und so weiter) gibt es den Schalter nicht.

Mehrere Fotos („Blätter")

Mit „+ Blatt" weitere Fotos hinzufügen. Alle Blätter landen in einem Einsatz. Im Eigenschaften-Fenster steht, von welchem Blatt ein Werkzeug stammt. Werkzeuge aus anderen Projekten holst du über 📚 Bibliothek → ⤓.

5. Schritt 3 – Individualisieren & Export

In der rechten Leiste schaltest du oben zwischen Einfach (nur Allgemein, Größe, Export) und Alle Einstellungen um.

Typ

Die Konturen bleiben beim Umschalten erhalten. Der Einsatz bleibt immer ein Stück. Den Puzzle-Modus („in Teile zerlegen") gibt es nur als Option, er ist standardmäßig aus.

Spiel um das Werkzeug

Kein 0 mm (stramm) · Klein 1,5 mm · Mittel 3 mm (empfohlen) · Groß 4,5 mm. „Zusätzliches Spiel" wird daraufgerechnet. Vor dem ersten Druck: lieber Mittel.

Taschentiefe

Die Standard-Taschentiefe gilt für alle Werkzeuge ohne eigene Tiefe, jedes Werkzeug kann eine eigene bekommen. Mit „Alle eigenen Tiefen zurücksetzen" nimmst du alle eigenen Tiefen wieder zurück. Die Seitenleiste zeigt dir, welches Werkzeug das tiefste ist. Das tiefste Werkzeug bestimmt die Gesamthöhe. Flache Werkzeuge (Schlüssel) lassen sich aus einer flacheren Tasche leichter greifen.

Werkzeuge anordnen

Formen hinzufügen

Kreis, Quadrat, Rechteck, Rundes Rechteck, Aa Text (erhabener Text oder Gravur), 🔩 Nüsse (Steckschlüsseleinsätze mit Größe und Antrieb) und 🧰 Bits & Nüsse (Anzahl). Formen ziehst du an den weißen Punkten auf die gewünschte Größe.

Bits und Nüsse mit Anzahl

Über 🧰 Bits & Nüsse (Anzahl) legst du viele gleiche Teile auf einmal an, ohne jedes zu fotografieren:

Anordnung wie im Werkstatt-Organizer: Die Werkzeuge bleiben, Bits und Nüsse entstehen als sortierte Blöcke daneben (rechte Spalte) oder darunter (volle Breite). Bits werden je Länge gruppiert, Nüsse je Antrieb und aufsteigend nach Größe, die Größe steht unter jeder Nuss. Von beiden Varianten gewinnt die, die am wenigsten Gridfinity-Zellen braucht. Passen die Teile nicht in einen Einsatz (maximal 10 × 10 Zellen), meldet Passmio das.

✨ Alles optimal anordnen (erscheint, sobald Bits oder Nüsse im Projekt sind): probiert zwei Anordnungen und nimmt die mit den wenigsten Zellen. Entweder liegen Bits und Nüsse als Blöcke oben links und die Werkzeuge werden drumherum gepackt, oder die Werkzeuge werden zuerst eng gepackt und Bits und Nüsse daneben. Die Werkzeuge behalten dabei ihre Ausrichtung (sie werden nicht gedreht) und stehen danach fest. Fingermulden wandern mit ihrem Werkzeug mit. Die Plattengröße passt sich automatisch an. Hochkant oder Quer bleibt, wie es war.

⤾ Hochkant / Quer machen dreht die ganze Platte. Die Zahlen bleiben waagerecht lesbar, die Platte wird bei Bedarf größer. In der Schubladen-Ansicht ist das Drehen gesperrt, weil die Schublade die Größe vorgibt.

Farben bei Nüssen: Bodenfarbe und Zahlfarbe stellst du getrennt ein. Die Zahl neben der Nuss auf dem Board bekommt automatisch dieselbe Farbe wie die Zahl in der Nuss.

Einsatz drehen (hochkant ↔ quer)

⤾ Hochkant machen / ⤾ Quer machen dreht den ganzen Einsatz um 90°. Die Werkzeuge drehen mit, Bits und Nüsse samt Zahlen werden neu geordnet und bleiben waagerecht lesbar.

Fingermulden

⬇ Vertiefung im Werkzeug

Für Teile mit einem dicken Kopf (Ratsche): eine zusätzliche, tiefere Mulde im Werkzeug. Das Werkzeug muss gewählt sein. Die Vertiefung ist ein Kreis, den du verschieben und in der Größe ändern kannst.

📷 Originalfoto zeigen

Blendet das Foto im Werkzeug ein, damit du siehst, wo Vertiefung oder Fingermulde hinsoll. Bei mehreren Blättern wird für jedes Werkzeug sein eigenes Foto gezeigt (beim ersten Einschalten dauert das einen Moment).

Werkzeugnamen gravieren

„Werkzeugnamen in den Taschenboden gravieren": Der Name erscheint als gestricheltes Feld entlang des Werkzeugs. Du kannst ihn ziehen, er bleibt dabei in der Tasche und dreht mit dem Werkzeug. Name ändern: im Eigenschaften-Fenster oben, das Feld mit dem gestrichelten Rand.

Beschriftung bei gekröpften Werkzeugen: Hat ein Werkzeug einen Hals und einen breiten Griff (zum Beispiel gekröpfte Schlüssel), setzt Passmio den Namen automatisch in den breiten Griff statt auf den Hals.

Gravur drehen: Im Eigenschaften-Fenster drehst du die Schrift mit ⟲ 15°, ⟳ 15°, +90° und 180° gegenüber der automatischen Richtung. Passt der Name danach nicht in die Tasche, bleibt die automatische Richtung. „Zurück" stellt sie wieder auf automatisch. Dort stellst du auch Farbe, Schrifthöhe (0 = Standard) und Fett für die Beschriftung dieses einen Werkzeugs ein.

Schrift einstellen: Direkt unter dem Schalter stehen Schriftart, Schrifthöhe (0 = automatisch passend) sowie Fett, Kursiv und Unterstrichen. Das gilt für alle gravierten Namen. Bei einem eigenen Text (Form „Aa Text“) stellst du Schriftart, Höhe, Fett, Kursiv und Unterstrichen im Eigenschaften-Fenster ein.

Zwei Ebenen übereinander

Kleine Werkzeuge in einer zweiten Platte unter großen unterbringen. Du druckst zwei Platten und legst sie übereinander.

  1. Einschalten unter „Ebenen".
  2. Großes Werkzeug bleibt in Ebene 1 (oben).
  3. Kleines Werkzeug anklicken, Knopf „nach Ebene 2 (unten) verschieben".
  4. Auf „Ebene 2" wechseln und das kleine Werkzeug genau unter das große schieben. Das große siehst du dort gelb gestrichelt.
  5. Export: ZIP mit beiden Platten.

Zwischen den Ebenen dürfen Werkzeuge überlappen, innerhalb einer Ebene nicht.

Schubladen

Mit dem Schubladen-Modus (nur Gridfinity) verteilst du die Werkzeuge auf mehrere Einsätze. Gedruckt wird pro Schublade ein Einsatz. Beim Export wählst du „alle Schubladen" (ZIP) oder nur die aktuelle. Schubladen und Ebenen schließen sich aus.

Farben und Mehrfarbdruck

Unter „Farben" legst du die Farben für Basis und Einsatz fest. Zusätzlich hat jedes Werkzeug eigene Farben im Eigenschaften-Fenster: Farbe der Auflage (Taschenboden), Farbe der Beschriftung und bei einem Text die Schriftfarbe. Jede dieser Farben wird im 3MF ein eigenes Teil, auch ohne den Haken unten, und die 3D-Vorschau zeigt sie. „Standard" im Farbfeld heißt: die Farbe des Modells. Mit dem Haken „Mehrfarbdruck: Taschenboden und Text als eigene Farbe im 3MF" (nicht bei Schaumstoff) erscheinen die Felder „Taschenboden" und „Text". Im 3MF sind Einsatz, Signalboden und Text dann getrennte Teile mit eigener Farbe, im Slicer weist du jedem Teil sein Filament zu. Fehlt ein Werkzeug, leuchtet der Boden in der Signalfarbe.

Material & Schrumpf

Material wählen (PLA, PETG, ABS, ASA, TPU, Nylon oder eigener Wert). Passmio rechnet den Schrumpf beim Abkühlen vorab ein, bewusst mit dem oberen Wert der üblichen Spanne (PLA 0,3 %, PETG 0,5 %, ABS 1,0 %, ASA 0,7 %, TPU 0,8 %, Nylon 2,0 %), damit es nicht zu knapp wird. Ein bestehendes Projekt behält seinen alten Wert, bis du das Material neu wählst. Mit dem Passform-Test druckst du ein kleines Probestück und stellst den Faktor aus der Messung ein („Faktor für alle Werkzeuge übernehmen").

3MF-Export: Drucker

Unter „3MF-Export: Drucker" wählst du deinen Drucker (Bambu Lab X1/P1/P2S/A1, A1 mini, H2D/H2S, Prusa MK4/MK3, XL, MINI, Anycubic Kobra). Passmio legt die Teile mittig auf das Druckbett dieses Druckers. Für Bambu Studio, Orca, PrusaSlicer und Anycubic Slicer Next. Passt ein Teil nicht aufs Bett, meldet das der Slicer.

Druckplan

„Druckplan berechnen" schätzt Filament, Zeit und Kosten pro Schublade und insgesamt. Du gibst Füllung (%) und Spulenpreis (€/kg) ein. Es ist eine grobe Schätzung (± 40 %), geeicht an einem echten Bambu-Slice (ca. 13 mm³/s plus 6 Minuten Vorbereitung). Der Slicer rechnet genauer, gleiche beim ersten Druck ab.

Export

FormatWofür
STL, 3MF, STEP3D-Druck (3MF mit Farben)
DXF, SVGLaser, CNC, Plotter, Schaumstoff
Größen-Check PDFMaßprüfung 1:1 vor dem Druck
Papier-Probe PDFEinsatz 1:1 auf Papier ausdrucken und Werkzeuge probehalber hineinlegen
Passform-Test STLKleines Probestück für den Schrumpf
Grundplatte STL / Leiste STLGridfinity-Grundplatte, Leiste für Nüsse
Positiv STL/STEPNur das Werkzeug selbst als dünne Platte (gewähltes, sonst alle), die Höhe ziehst du im CAD auf
Inventurliste CSV/PDFListe der Werkzeuge
DruckplanBerechnet Druckzeit, Gewicht und Kosten

Vor jedem Druck: Größen-Check-PDF in 100 % („Tatsächliche Größe", nicht „An Seite anpassen") drucken, mit den Linealen die Skalierung prüfen, dann die echten Werkzeuge auf die Umrisse legen.

Projekt sichern und teilen

Passmio speichert automatisch im Browser. Zusätzlich kannst du das Projekt als Datei auf deinem Rechner sichern:

Die Datei kannst du auf einen anderen Rechner kopieren oder weitergeben. Sichere wichtige Projekte zusätzlich als Datei, falls die Browserdaten gelöscht werden.

6. Warnungen und was zu tun ist

MeldungBedeutungLösung
Überlappung(en) (rot im Layout)Zwei Taschen berühren sich, das kann Exportfehler gebenAuseinanderziehen, oder bei Ebenen ein Teil in die andere Ebene legen
Tasche(n) ragen über den RandTasche liegt außerhalb der PlatteVerschieben, „Größe automatisch anpassen" oder „Automatisch verteilen"
Tasche(n) zu nah am RandAußenwand dünner als 1,2 mm, im 3D-Modell entsteht eine LückeNach innen schieben oder Platte vergrößern
Foto-Check mit RestfehlerPerspektive ist nicht ganz ausgeglichenHöhe ableiten, weiter weg fotografieren

Fehlerprotokoll (🐞)

Oben in der Kopfzeile steht ein 🐞. Eine Zahl daneben zeigt neue Fehler, die Passmio selbst bemerkt hat. Ein Klick öffnet das Protokoll. Dort kannst du auch selbst ein Problem notieren (zum Beispiel „Mulde sitzt falsch“). Mit „Kopieren“ oder „Als Datei“ schickst du es weiter, damit der Fehler gefunden werden kann. Das Protokoll bleibt in deinem Browser. Fotos und Projektinhalte sind nicht enthalten.

7. Tastaturkürzel

TasteWirkung
N oder EnterNeues Werkzeug
Strg/Cmd+ZRückgängig
Strg+Shift+Z oder Strg+YWiederholen
EntfLöschen
EscModus beenden
[ und ]Gewähltes Werkzeug 1° drehen (mit Umschalt 5°)
GGerade ausrichten

8. Fehlersuche

9. Begriffe