Files
The Files tab is where you import and manage all project data. Drag and drop a ZIP package or individual files onto the panel, and Gerbtrace auto-detects file types and layer classifications.
Importing files
Drop files onto the import area or use the file picker. Gerbtrace accepts:
- Gerber files (.gbr, .ger, .gtl, .gbl, etc.) – auto-classified to layer types
- Drill files (.drl, .xln, .exc) – plated and non-plated
- Pick and Place (.csv, .tsv, .txt) – component placement data
- BOM (.csv, .xlsx, .xls) – bill of materials
- PDF documents – schematics, drawings, datasheets
ZIP archives are extracted automatically and each file is classified individually.
File groups
Imported files are organized into collapsible groups:
- Gerber Files – copper, mask, silk, paste, and outline layers
- Drill Files – through-hole and via drill data
- Pick and Place – SMD and THT placement files
- Bill of Materials – BOM data files
- Documents – PDF files categorized as drawings, schematics, or datasheets
Each group shows a count badge and can be collapsed or expanded.
Layer classification
Every Gerber file has a layer type assignment (Top Copper, Bottom Solder Mask, Outline, etc.). Gerbtrace assigns types automatically based on file names and extensions. If the auto-detection is wrong, use the dropdown next to each file to change the type manually.
Generated outline
If a design has no Outline or Keep-Out layer, the Import checks box offers Generate rectangular outline from board extents. After you confirm, Gerbtrace adds generated-outline.gbr, a rectangle around the copper, solder mask, paste and drill layers, classified as Outline. Silkscreen is left out because logos and fabrication notes often sit off the board. Set a margin in millimetres (default 0) to grow the rectangle on every side.
The generated outline makes board size, cropping, realistic rendering and panelization work. It is still an approximation, not the customer's board contour:
- The file is marked as generated (a
gerbtrace-generated: outline/board-extentscomment in the Gerber and a Generated badge in the file list). - JPSys export never uses it as the machine frame. Jet printing still needs a closed outline from the design data (see Jet Printing).
- If no PnP origin is set, generating the outline pins the origin at (0,0), the one in effect without an outline, so components keep their positions. Removing the generated outline clears that pinned origin again; an origin you set yourself is kept.
- Remove it with Remove generated outline or the file's actions menu. To change the margin, remove it and generate it again.
Ask the customer for the real board outline before production whenever the shape is not a plain rectangle.
File actions
Each file row has an actions menu with options to:
- Download the original file
- Remove the file from the project
- Reassign the layer type
File preview
Click a file to see a preview in the right panel. Gerber and drill files render a visual preview; PDF documents show the first page.
Drill format
For a drill file, the preview header shows the coordinate format the file is read with (for example 2.4 inch) and where it comes from: stated in the file, the tool table, the Excellon default, the board check at import, or your choice.
An inch file that states no format can be read as 2.4, 2.5 or 2.6, and each reading puts the holes ten times further from or closer to the origin. For these files the header has a Format menu: Auto uses the format whose holes fall inside the board, or pick 2.4, 2.5 or 2.6 yourself. When the board check recommends another format than the one in use, a Use 2.x button switches to it; its tooltip says why (holes outside the board, fewer holes on copper pads, or holes pulled towards the origin). The choice is stored in the file as a ;FORMAT= comment, so exports, the 3D view and the assembly drawing read the same holes, and Reset to original removes it.
Lock
In team projects, the Unlocked / Locked toggle in the top-right corner controls whether files can be imported, deleted, or reordered. Locking the Files page prevents accidental changes while other team members are working on the project.