Beam Bench project files

A Beam Bench project is stored as a single .lzrproj file. The format is a zip archive and self-contained: opening a .lzrproj file gives you everything that was on the canvas when it was saved.

What it contains

A .lzrproj file holds:

• Objects: every shape, text, image, group, and array on the canvas, with their geometry, transforms, and layer assignments.
• Layers: per-layer cut settings (operation, power, speed, passes, interval, perforation, kerf).
• Machine profile reference: which profile was in use when the project was saved.
• Camera state (if any), selected camera id, alignment / calibration references.
• Material library refs: by name. If the recipient has the same library names, the references resolve.
• View state: pan, zoom, panel layout.
• Project notes: content from the Notes dialog.
• Optimization: output-side optimization settings (see the Laser Control Optimization section).
• Job origin + Start From: the placement strategy.
• Recent autosave metadata (when applicable).

Raster image data is bundled inline (base64 or similar), so projects with images are larger but always portable.

How to read and write

• GUI: File → Save (Ctrl+S), File → Open (Ctrl+O), File → Save As (Ctrl+Shift+S).
• CLI:

  beambench-cli project open /abs/path/to/project.lzrproj
  beambench-cli project save
  beambench-cli project save-as /abs/path/to/new.lzrproj

• HTTP API: POST /api/v1/projects/open and POST /api/v1/projects/save.

Sharing projects

A .lzrproj file emailed or uploaded to someone else opens with the same canvas state, the same layer settings, and the same view. They will see:

• All objects in the same positions.
• All layer settings identical.
• Material library references resolved if they have a matching library, or showing a warning if not.

What does not travel:

• The active machine connection (their machine).
• Per-user preferences (display unit, panel layout overrides applied at the user level).

Edge cases

• Very large raster images make for large .lzrproj files. If your project is too big to attach to a bug report, consider downsampling rasters first.
• Material library references resolve by name. If your library has Acrylic 3mm and the recipient has Acrylic 3mm with different settings, the recipient's settings win after open.
• Machine profile references resolve by id. If the recipient does not have the same profile, they will be prompted to pick one on open.

Format compatibility

Pre-release. The schema can change between releases without warning. Save important projects in their current format before updating Beam Bench. There is no backwards-compatibility shim yet, that is a post-1.0 concern.

Related

• .bbart art libraries: for reusable artwork
• Save the project (Get Started)
• Recovery dialog
• Supported imports
• Supported exports