Bernie User Guide

Bernie prepares and runs laser engraving and cutting jobs: you draw or import, set up each layer, check the preview, then send the job to the machine. This guide follows that path.

Finding help: F1 opens this guide at the topic of what you are doing (tool, text, image, preview…); the "?" buttons of the panels lead to their topic; Help › My job is… and "Something wrong with the result?" (layer settings) start from what you see and suggest which settings to change. Beginner mode (Settings › General): layer settings are limited to the essentials; advanced options still apply.

Safety first. A laser burns skin and eyes and can start a fire. Wear glasses rated for your laser's wavelength, never leave a machine running unattended and keep the stop within reach (⌘. or the STOP button). See Safety.

What's New

The latest features, newest first (details in the sections linked).

Getting Started

Bernie tour

At first launch, as long as no device is set up, Bernie opens on an animated tour: a welcome screen, then five steps, about two minutes.

  1. Three steps: draw, set up (each color is a layer), engrave.
  2. Your laser: diode, CO2, fiber / galvo, cutter / plotter (see Cutters and Plotters: the search is skipped), or no laser yet (the virtual laser, to try everything).
  3. Find the laser: Bernie queries the USB ports (without any movement) and looks for lasers announced on the network; if yours doesn't show up, Choose from the catalog (commercial machines, by brand), Custom Machine (a machine that is not in the catalog, set up in the next step) or Import a profile (Bernie, .lbdev).
  4. Your machine: Controller for a catalog or custom machine (GRBL, including FluidNC and DLC32 boards, Marlin, Smoothieware, or the stock M2 Nano board on a CO2 laser; in Bernie Studio, GRBL or the M2 Nano board, on a CO2 laser), work area, origin (zero corner), homing at startup, and the linked material library — the machine's own when the catalog has one, otherwise a starter library for the laser type. The profile is saved at the end of this step (it replaces the sample starter profile).
  5. All set: Engrave a material test (the test window opens, nothing runs without you), Open a sample project (the Bernie logo: a coaster for a diode, an acrylic key ring for a CO2, a metal tag for a fiber — settings are a starting point) or Start from a blank page.

Skip (or Esc) closes the tour at any time; nothing is saved before the end of “Your machine”. The tour never moves the head and never fires the laser. To see it again: Settings › General › Show the Bernie tour again, or Help › Bernie Tour…; with no device set up, the Laser panel also offers Add a Laser…. With “Reduce motion”, each scene is shown directly.

On iPad, the tour fills the screen (the scene above the text in portrait) and the search goes over the network: Wi-Fi lasers, Bernie Link and Macs in Hub mode (their pairing code is required and is entered here); open it again from Preferences. On iPhone, a short version — Welcome, Find the laser, All set — saves the laser to use from the workshop.

In Bernie Studio and the desktop app (Windows, Linux), the tour opens at first load when no device is set up in this browser or app; open it again from Help › Bernie tour…, from the button in the manual window or with Add your laser… in the Laser panel. The desktop app looks for the laser over USB and the network; in a browser, you choose your machine from the catalog (the USB link, in Chrome or Edge, is then made from the Laser panel). The machine's material library is then offered first in Material library.

Add a Laser… starts the assistant on the laser steps only (type, search, catalog, work area and origin), with no welcome or first project; the laser joins your devices and becomes the active one. It is in the Laser menu, the Help menu and the Laser panel when no laser is connected; on iPad, in More; on iPhone, in the project; in Bernie Studio, also in the preferences.

Interface tour

At the end of the Bernie tour, Interface tour afterwards (on by default) leads into a short tour: the rest of the window dims and a bubble shows in turn the tools, the workspace, the colors (one color, one layer), the layer settings, the Laser panel and the status bar. Next and Back move from one area to the next, End Tour (or Esc) closes it; nothing in the project changes. If you chose the material test, its window opens when the tour ends.

To take it again: Help › Interface Tour, or Settings › General › Interface Tour (on iPad, in Preferences). In Bernie Studio and the desktop app, the tour shows the tools, the workspace, the layers, the Laser tab and the status bar; start it from Help › Interface tour. On iPhone, the short Bernie tour offers no interface tour.

Step by step

  1. Choose your device: Settings › Devices. Bernie offers the Ortur Laser Master 2 and GRBL, Marlin and Smoothieware templates; “Find My Laser” queries the USB ports and creates the profile from the connected machine.
  2. Draw or import: tools in the left bar, or File › Import… (⌘I: SVG, DXF, PDF, Illustrator, images). You can also drop a file on the window or paste from another application.
  3. Set up the layers: each layer has its color, its mode (Line, Fill, Image), its speed and its power. See Layers.
  4. Check the preview (eye button): paths, estimated time, pre-flight check.
  5. Connect and engrave: Laser panel. Without a machine, the virtual laser shows the job as if it were engraved.

Support Bernie: Bernie is free. Help › Support Bernie… (on iPad, also in the Help menu, the question mark at the top right; on iPhone, the heart in the Help tab) offers three tips through the App Store; they unlock nothing — everything is already included.

Rate Bernie: in the App Store version, Help › Rate Bernie… (on iPad, the Help menu; on iPhone, the star in the Help tab) opens the App Store review page. After a few successful jobs on your laser, Bernie may also show Apple's small rating window — never during a job, at most once per version; dismissing it changes nothing. In Bernie Studio, a Support Bernie button leads to the donation page.

The Window

Drawing

ToolUse
Select (V)Click, or drag a rectangle; Shift adds or removes. Handles: resize, rotate. Shift while moving: 45° directions. Tab / Shift-Tab: next or previous object.
Rectangle (R), Ellipse (E)Drag; Shift for a square or a circle, Option to start from the center.
Polygon (P)Drag; number of sides in the inspector.
Path (L)Click: corner; click-drag: curve; S: smooth nodes on click (or the status bar button); Shift: 15° angle steps; Return: finish; click the first point: close. Started on the end of an open path, it continues it; finished on an open end, it joins it (and closes the path if it comes back to its start).
Text (T)Click then type in the field that opens below the text; font, height, bold, italic, alignment, spacing, arc in the inspector.
Nodes (N)Edit the points of a shape: move (Shift: horizontal, vertical or 45°; arrows: by the keyboard step), insert (I), delete, smooth (S) or corner (C), break (B), close (F). On the segment under the pointer: L straightens it, S turns a straight segment into a smooth curve (joined to its neighbors without a corner, then bent with its handles), A aligns it (horizontal, vertical, 45°), T trims it up to the nearest crossings, E extends the open end to the next outline.
Trim (X)Click: removes the part of a line between two intersections; leftover pieces that touch (two trimmed circles…) are welded into a single path, which is selected. ⌘-click: without welding. Shift-click: the removed segment is kept, copied to the active layer.
TabsClick a contour: adds a tab (uncut bridge holding the part); click a tab: removes it.
Measure (M)Drag to measure a distance and its X and Y offsets; Shift: 15° steps.

Numeric entry: the inspector gives the position, the size (in mm, inches or %), the rotation and the mirrors. The 3 × 3 grid chooses the point of the selection that X and Y refer to (corner, middle of an edge, center), the fixed point when resizing and the center of rotation: clicking another point changes the values shown, not where the selection is (as in LightBurn); to move it, type X or Y. X and Y, like the rulers and the pointer position, are measured from the device origin: with a bottom-left origin, Y starts at the bottom of the bed. “Keep proportions” also applies to the corner handles (Shift reverses it for one gesture).

After drawing, Bernie goes back to the Select tool: the shape you drew (or imported) is ready to be moved or resized. To draw several shapes in a row with the same tool, turn off “Return to the Select tool after drawing” in Settings. Even with a drawing tool active, the selection handles stay usable: the cursor changes when you hover them.

Snapping: to object nodes, segment midpoints, intersections and centers (⌘') or to the grid (⇧⌘'), View menu (in Bernie Studio: two checkboxes in the status bar); Ctrl suspends it for one gesture. While moving a shape, alignment guides (magenta) appear when its edges or center line up with another shape's. The grid spacing is set in the preferences (automatic by default). A rectangle's corner radius is set in the inspector.

Rulers and guidelines: graduated rulers (design unit) border the canvas (View › Rulers, ⌘R). Drag from the top ruler to place a horizontal guideline, from the left one for a vertical one; shapes and points snap to them. With the Select tool, drag a guideline to move it; dropped back on its ruler, it disappears. They are saved with the project; View › Clear Guidelines removes them all. In Bernie Studio: rulers in millimetres (Rulers checkbox in the status bar); the rulers' “×” corner clears the guidelines.

Live dimensions: while drawing, next to the pointer — shape size, length and angle of the current segment, selection offset. Measurements (inspector, collapsible section): perimeter, area (holes are subtracted), extent, closed or open paths, nodes, straight and curved segments of the selection.

Keyboard: arrows move the selection, Shift for a large step, Option for a fine step (adjustable in the preferences).

Parametric Sketches

A sketch is a shape defined by constraints and dimensions rather than by coordinates: a rectangle always three times wider than the material is thick, a notch always centered, a hole always tangent to an edge. Change a dimension, or a project parameter, and the shape recomputes. On Mac, iPad, in Bernie Studio and the desktop app (not on iPhone).

Starting: the Parametric Sketch button at the bottom of the tool palette (also in the Tools menu on Mac, the Edit menu in Bernie Studio). To resume a sketch: double-click it, or select it and use the same button. Finish Sketch (or Esc when nothing is in progress) returns to ordinary drawing: the sketch is then an object like any other (layer, moving, engraving, cutting).

ToolUse
Selection (V)Click a point, a line or a circle; Shift adds; drag a rectangle to select what is inside. Drag a point, a line or the edge of a circle: the shape follows and keeps its constraints.
Lines (L)Click after click; a nearly horizontal or vertical line becomes one (constraint added automatically). Click an existing point: the chain joins it and stops; double-click or Esc: finish.
Rectangle (R)Two opposite corners; its sides stay horizontal and vertical.
Circle (C)The center, then a point on the circle.
Arc (A)The center, the start, then the end (clockwise).

Constraints (bar above the workspace; only those that apply to the selection are enabled): coincident, horizontal, vertical, parallel, perpendicular, tangent, equal, symmetric (two points and an axis), midpoint, on element, fixed. Dimensions: distance (between two points, length of a line, from a point to a line, between two parallel lines), horizontal and vertical distances, angle, radius, diameter. A dimension takes the measured value and opens its entry: a number (units allowed: 2 cm, 1 in, 45°) or an expression (width / 2 - gap). Double-click a dimension to change it; a dimension computed by an expression shows “ƒ”.

Colors: blue for what can still move; black for what is fully determined; orange for the selection; dashed for construction elements (Construction button: they guide the drawing and carry constraints without being engraved). The bar shows the remaining degrees of freedom, then “Fully constrained”. A constraint that conflicts with the others is refused (nothing changes); a constraint already imposed by the others is kept but flagged in orange: select its label, then Delete.

Project parameters (Parameters… button in the bar): names and their expressions, which can refer to each other (thickness = 3, width = 10 * thickness). The dimensions of every sketch, on every page, can refer to them: change the thickness and they all follow, in a single undoable action. A sketch that cannot follow (constraints that became incompatible) keeps its shape, and the window says so. Expressions: + - * / % ^, parentheses, pi, sqrt abs round floor ceil min max sin cos tan asin acos atan (angles in degrees), decimal point or comma (2,5), function values separated by ; or , (min(3; 5)).

A project with sketches is saved in a format that earlier versions of Bernie refuse to open (without damaging anything). Convert to Path turns a sketch into an ordinary path, without its constraints.

Editing Shapes

Text and Codes

Text uses the fonts installed on the device; its outline is saved with the project, which therefore opens identically elsewhere. Options: line spacing, welded letters (a single outline), anchoring, text on an arc, capitals (the typed text is kept), maximum width (a longer line is squeezed), right to left (Arabic, Hebrew: words run from right to left; a Hebrew word in an English sentence always reads in its own direction). The star next to the font adds it to the favorite fonts, listed first. Category narrows the font list: sans serif, serif, monospace, script, decorative. Browse Fonts… opens the full list with a search by name and a preview of each font with your text.

Variable text: a text whose codes are replaced by values when engraving — the text's Variable Text list: Serial Number (d decimal, h/H hexadecimal, as many digits as letters, a leading 0 pads with zeros: “No 0ddd” → No 042), Date and Time (dd/MM/yyyy, HH:mm, dddd day name, MMMM month, w ISO week, AP AM/PM…), CSV Merge (%0, %1…: columns of the current row of a CSV file), Cut Settings ({speed}, {power}, {min-power}, {passes}, {interval}, {layer}: the settings of the text's layer, to label a test grid). A barcode or QR code can be variable too (Code section: mode, offset, encoded data). A grid (Array…) can advance the variable text from one copy to the next (step per copy). Text between apostrophes is copied as is ('Lot' dd). Offset: added to the counter, to number several labels of one template; in a virtual array, each copy takes the next value. Variable Text… sets the project counter (current value, start, end, step; previous, next, reset), its advance after each output (job start, G-code file), the CSV file and “ignore empty fields” (no blank line). The design keeps the codes; Show in Preview shows the values as they will be engraved. Bake Values replaces the codes with the current value: the text (or code) becomes ordinary (undoable).

SHX fonts (single-line): AutoCAD single-stroke fonts engrave a text in a single pass, without fill (layer in Line mode). Set their folder in Settings › Editing › Text › SHX Fonts (Bernie Studio: SHX Fonts… under the font, files kept in the browser); they appear in a separate section of the font list. Formats read: shapes and unifont (not the Asian bigfont).

Text on a path: select the text and a path (line, curve, circle…), then Shapes › Apply Path to Text. The text follows the path, which becomes part of the text; on a closed shape it starts on the left side and goes over the top, outside. Alignment places the text at the start, middle or end of the path, Offset along path slides it, vertical anchoring puts it on, under or above the path. With the Nodes tool, the path's nodes are shown: move, add or delete them and the text follows. Detach Path gives the path back and straightens the text.

Editing text: double-click it (double tap on iPad). A field opens below the text and the canvas follows your typing; ↩ or Esc finishes, ⌥↩ starts a new line, clicking elsewhere also finishes. The same field opens when you place a new text: just type, your typing replaces “Text”. For a long text, Edit Text… (inspector) opens a large field where Return starts a new line; Settings › Editing › Text can open it on double-click.

Missing fonts: a project opened on a computer that lacks its font keeps the saved outline of its texts. Tools › Replace Missing Fonts… (in Bernie Studio: the link under the font of an affected text) picks an installed font for each one: the texts are redrawn with it and become editable again (a single action to undo).

Codes (QR button in the left bar, ⇧⌘K): QR, Data Matrix, Code 128, Code 39, Code 93, EAN-13, EAN-8, UPC-A, UPC-E (6 digits, or 7 with the number system 0 or 1 first), Codabar (start and stop letters A to D added when missing), Interleaved 2 of 5 (ITF; with 13 digits the check digit is added: ITF-14 for cartons), with helpers for a Wi-Fi network or a contact card. The content is checked before insertion; Characters Left shows the room still available. QR code: error correction low, medium, high or maximum (share of the code that can be damaged or covered by a logo; the higher it is, the larger the code). Barcodes: readable text below the code (with the check digit of EAN, UPC and ITF-14). Data Matrix: square by default; otherwise a lower, rectangular format is chosen when it is smaller. Control characters: in the data, \F (leading FNC1: GS1 Data Matrix), \G (GS separator between two GS1 elements), \n, \t, \xHH (hexadecimal code), \\ (backslash). EAN-13 and UPC-A: a 2- or 5-digit add-on code (price, issue number) is typed after a “+” (590123412345+12); its gap to the main code is set in modules (7 to 12 recommended).

Vision markers (same window, AprilTag 16h5, 25h9, 36h10, 36h11, ArUco MIP 36h12, ArUco 4 × 4 to 7 × 7 types): targets for computer vision software (OpenCV, AprilTag), to locate a part or calibrate a camera. Type the marker number (from 0 to the family's number of markers minus one); the marker is engraved with its black border, in the orientation of OpenCV's cv2.aruco.generateImageMarker; the quiet zone adds one module around it (the material must stay light around the marker for it to be detected).

Images

An imported image is engraved on a layer in Image mode. In the inspector: brightness, contrast, gamma, sharpening. Mask (Tools › Apply Mask to Image): a closed shape selected with the image limits the engraving to its inside; a shape placed inside another makes a hole (removing the center of an image); Remove Mask gives it back as a shape, to edit and apply again; Crop Image cuts the image to the mask. In Bernie Studio, these three buttons are in the panel's Image section.

Trace (Tools › Trace Image…, ⌥⌘T): turns an image into outlines, with preview, threshold, smoothing and area. Sketch: for a drawing photographed with shadows or uneven lighting, keeps the lines darker than their surroundings (the threshold becomes a sensitivity). Centerline (Middle of the Strokes): instead of the outline of each stroke, a single open path along its middle — for a line logo, a sketch, handwriting, to engrave or cut as a line (the result goes on a layer in Line mode). The short branches caused by the stroke thickness are removed; “Simplification” and “Smoothing” set how fine the paths are. A solid blob (a dot) has no centerline.

Engraving settings (layer in Image mode): line interval (or DPI), dithering (Stucki, Floyd-Steinberg, Jarvis, Atkinson, ordered, threshold, grayscale, pass-through, halftone — round dots sized by darkness, adjustable cells per inch and angle —, newsprint — fine halftone at 45° —, sketch — only the outlines of the image are engraved), negative, dot width correction.

3D sliced (galvo device): a depth map — grayscale image, dark = deep — engraved in as many slices as passes (often several hundred); each slice engraves what is darker than its level, so a pixel gets more passes the darker it is. A 16-bit map (PNG, TIFF) keeps its precision beyond 256 slices, as long as the image is not adjusted (brightness, contrast…); the Image section shows the color depth of the selected image. Slices between cleanups: a cleanup pass (soot, debris) every N slices, with the settings of the first sub-layer (created if there is none: tighter interval, lower power…), over the slices engraved since the previous cleanup or over the whole image.

Other tools (Image section of the inspector): Replace the image with another file in the same place (same scale, or in the same frame); Save Processed Image… (PNG of the image as it will be engraved); Flatten the mask (masked areas become transparent in the file). Shapes › Convert to Bitmap turns vector shapes into an image (254, 300 or 508 DPI).

Presets ("Preset" menu at the top of the Image section of the inspector): apply the image settings and its layer settings in one step (a single undo). Bernie provides four — Basic, Black Paint on White, Photo on Wood, Slate or Black Anodized — which never change speed or power.

Layers

Each layer is a laser process, identified by its color.

Cut Settings

Sub-layers

A sub-layer applies other settings to the same objects, after the layer: for example a fill, then an outline for clean edges. “+” button next to the “Layer / Sub-layer” choice in the settings. Global passes (layer settings, when it has sub-layers): the layer then its sub-layers, in order, repeated this many times — for example alternating fill and outline for deep engraving; the angle added per pass keeps turning from one repetition to the next.

Material Library and Test

3D models

File › Import… (or Import 3D Model… in Bernie Studio, or drag and drop) accepts STL models (binary or text), OBJ, 3MF (parts, components and transforms, slicer files included), PLY, OFF and AMF. The model is seen from above, in orthographic projection, and becomes a depth map: a grayscale image where white is the highest point of the model (the material surface, nothing engraved) and black the deepest. A window shows its preview and sets:

The map (16-bit) is placed in the middle of the bed on an Image layer in grayscale — power follows depth — or in 3D slices on a galvo device; a layer that already holds shapes is left alone. The actual depth depends on power, speed, interval and number of passes: a material test and the 3D simulation help choose them; a deep relief usually needs several slow passes.

Perfect image engraving

Laser › Calibration Patterns › Perfect Image Engraving… guides the five settings, in order, on the same material: focus (Z height test), speed and power (a nicely dark cell that doesn't dig too deep), scan interval (lines that touch without overlapping, under a magnifier), dot width correction (test above), then image adjustments (brightness, contrast, gamma, sharpness in the inspector). Each step opens the right tool; note each value found in the material library. In Bernie Studio: Laser panel › Perfect Image Engraving… (the focus test appears with a motorized Z axis, as does the material test's “Focus: Z Height” preset).

Preview and Pre-flight Check

The eye button (or ⇧⌘P) shows the laser paths: engraving in the layer color, laser-off moves in gray, rapid moves in red. The time slider replays the job; “Shading” darkens the lines according to power; the rendering shows the engraving in the layer colors, inverted (light on a dark background) or on a material — light wood, plywood, cardboard, leather, slate, black acrylic, black or blue anodized aluminum: the surface takes the material's color, the mark its own, darker or lighter depending on the power, engraved images included (Bernie Studio: list next to the Preview button); “Legend” lists the layers sent with their mode, speed and power. Image saves the preview as a PNG (work area, 10 pixels per mm). Why this line?: a click on a line of the preview highlights it and tells what it is — laser on, laser off move (overscan, gap crossed, lead-in, tab) or rapid —, its layer and mode, its speed, power, length and time in the job; Select Object finds the shape it comes from.

The estimated time takes the device's maximum speeds and accelerations into account; the banner details the laser-on time and the travel time.

The pre-flight check reports what would prevent the expected result: nothing to engrave, leaving the work area (overscan included), speed beyond the machine, overscan too short, open shapes on a fill layer, duplicates (two identical shapes cancel out when filled), hidden layer still sent, image on a layer not in Image mode, cut planned before the engraving it surrounds… Click the line for the full list; Show selects the objects concerned. Blocking findings prevent starting.

Optimization (Laser menu › Cut Order Optimization…): inner shapes first, reduced travel, groups in one go, shape cut priority (inspector › Cutting), start on a corner, overlapping lines removed; or drawing order. Cut in a set direction takes shapes in order of their position (bottom to top, left to right…) instead of the nearest one: useful when cut parts lift or smoke drifts to one side. Hide backlash approaches every cut from the same side, so slack in the belts doesn't shift the start of outlines. Reduce direction changes: at a comparable distance, the next shape is the one that best continues the movement, so the head keeps its speed. Choose best direction: a closed shape may be run backwards if its first segment better continues the approach (except shapes with a set start and direction).

3D simulation

The job in 3D, to see where, in what order and roughly how deep the laser works: the workpiece (the job and a margin) on the bed is carved and darkened over time, the head follows the job and its beam lights up with the laser; on a galvo, the head stays still and the beam is deflected; with the rotary, the cylindrical object turns under the head. Open it with Laser › 3D Simulation… (Mac, in its own window), the 3D button of the preview banner (Mac, iPad), More › 3D Simulation… (iPad, full screen), 3D Simulation in the Job section (iPhone), or View › 3D Simulation… and the button of the Job preview card (Bernie Studio, Windows, Linux).

It is an approximate simulation — the energy of each move (power and actual duration, accelerations included) spread over the width of the spot —, not a prediction: the actual depth depends on the material, the focus and the machine; a material test remains the reference.

A 3D button also opens it from the top bar, next to the preview's eye (Mac, iPad, Bernie Studio, Windows, Linux). On Mac, the simulation follows the project: change a layer's speed or power, move a shape, and it updates by itself, at the same point in the job, with the same view and settings. The Laser and Thickness fields apply without confirming.

The Laser

The Laser Panel

The Laser panel reads from top to bottom, in order of use, and looks the same whatever the laser: connected by USB, over the network, virtual laser, or shared by Bernie Link or a Mac.

Focus: the head goes to the center of the work area, then Turn On the Spot lights the laser very weakly (0.5 to 10 %, 1 % by default), head still, 30 seconds at most (Extend, Turn Off). Screw or unscrew the diode — or raise and lower the head — until the spot is as small and sharp as possible; then check with the focus pattern of the Material Test. Wear suitable glasses, even for a weak spot. With Bernie Link, the power is capped by Bernie Link itself (10 % of the controller's maximum power, 60 s).

Connection

Laser panel › link mode:

If the USB connection fails, Bernie gives the reason: port already in use by another program (LightBurn, a serial terminal, another Bernie window) — close it, then reconnect; port not found — check that the laser is plugged in and switched on, and try another cable (some only carry power). Recent versions of macOS recognise the common USB chips; otherwise, install their maker's driver (WCH for the CH340, Silicon Labs for the CP2102). A GRBL controller set to report in inches ($13=1) is supported: its positions are converted to millimetres.

On connection, Bernie reads the controller settings and reports mismatches with the profile (maximum power $30, laser mode $32, travel), as well as a workpiece offset (G54, G92) left active, which would shift every job in absolute coordinates.

Ports that are not lasers (Bluetooth, modem…) can be hidden from the list (crossed-out eye button next to the port); the same menu shows them again.

Device Orientation

If an engraving comes out mirrored or upside down, the origin chosen in the profile does not match the machine. Laser › Check Device Orientation… (or the Laser panel):

  1. Engrave: a small “F” at the centre of the bed, at low power (height, speed and power adjustable; Frame shows the location first).
  2. Look at it from the front of the machine and pick the matching thumbnail: upright, mirrored left-right, mirrored top-bottom, or upside down.
  3. Bernie tells you the right origin corner and changes it in the profile in one click; engrave again to check.

On the virtual laser the “F” always appears upright: this test is for the real machine.

Devices

Settings › Devices: New starts from a template, from a Commercial machine, grouped by brand (Acmer, Atomstack, BlazeX, Creality, Emblaser, K40, LaserPecker, Longer, Makera, Mecpow, NEJE, Ortur, Sculpfun, Snapmaker, TwoTrees, xTool, G-code MOPA source: the model's work area, the actual travel being read back on connection; depending on the machine, port speed, macros, start G-code and scan offset compensation; in Bernie Studio, the profile's “Commercial machine” list), or From the Connected Laser (GRBL) — work area, maximum power, speeds and accelerations read from the controller. A machine marked “file preparation only” has a controller Bernie does not drive: the profile is used to prepare jobs at the right size. Export This Profile… saves the profile as a JSON file, which you can edit and import again. Import a profile (Bernie, .lbdev)… reads a Bernie profile or a .lbdev device profile: each device in the file becomes a profile (the first one is shown), its macros are added to those of the Laser panel (a macro with the same name is replaced), and a “Device added” window lists what has no equivalent in Bernie (process offset, unsupported controller…). Recognized controllers: GRBL and its variants (GRBL-M3, GRBL-LPC, Gerbil), Marlin, Smoothieware, custom G-code (Duet / RepRapFirmware flavor included); a JCZ galvo board becomes a galvo profile whose field is the work area (board settings and lens corrections: Import an EZCad Configuration); a Ruida is kept to prepare jobs, sent with the Ruida export. Work area, machine origin, firmware (GRBL, Marlin, Smoothieware), S max, baud rate, air assist, G-code added at the start and end of the job, return at job end. Icon: an image of your own for the laser (reduced to 128 pixels), shown next to its name in the profile list.

Ortur and Aufero: the whole range is in the catalog, older models included (Laser Master 1, 2, 2 S2, 2 Pro, 3, 3 LE and H10; H20, F10, R1 and R2; Aufero Laser 1, 2 and 3), over USB at 115,200 baud. Find My Laser reads the model name from the controller. On the Laser Master 3, H20, R1 and R2, pick the line for your module: the work area depends on it. A Laser Master 3 can start in alarm 11: run homing; over Wi-Fi, it answers at its address, port 23. The R1 only starts with its USB key. Extension kit: set the profile's depth and $131 on the controller (800 mm for the Laser Master 2 S2 and 2 Pro, 850 mm for the Laser Master 3, 600 mm for the Aufero Laser 2).

xTool D1 and D1 Pro: over USB at 230,400 baud (catalog machine, or pick that speed when connecting). Their firmware, close to GRBL, is recognized when connecting: Bernie asks for the position with a “?” sent as a line, works out the machine state from it and sends the job one line at a time. On these machines there is no speed or power override during a job and no cancelling a jog once started; Stop resets the controller. The controller acknowledges every command, even a wrong one, without reporting an error: double-check what you type in the console.

Other xTool machines: the D1 Pro 2.0 and the S1 also connect over USB (same firmware, 230,400 baud). The M1, M1 Ultra, P2, P2S and the F1, F1 Lite, F1 Ultra and F2 Ultra galvos have no serial port for G-code: Bernie sends them the job over the network — see Networked xTool. The M2 (files specific to xTool Studio) is not supported.

AtomStack: the whole GRBL range is in the catalog (A5 to A70, P7, P9, S10 to S40, X7 to X70), over USB at 115,200 baud; the recent P1, P1 Dual, Swift, Swift Mini, Kraft, Glacier and the Hurricane CO2 (GRBL board) at 460,800 baud. The M4 and M4 Pro galvos (another maker's board) are not supported.

Longer Nano and Nano Pro: a diode galvo running GRBL, 100 × 100 mm. Over USB at 921,600 baud; over Wi-Fi, join the machine's LongerLaser_Nano… network, then connect to the address 192.168.0.1:8847. Carving mode ($nano/work/mode=1) is sent when you connect; Commands on Connect, in the profile's added G-code, serves any machine that must first be put in a mode. Extensions: macro Switch Slide Extension (set the work area to 100 × 300 mm in the profile) and macro Switch Rotary Extension (enter the workpiece diameter after workpiece=). Before running Connect to WIFI, enter your network's name and password in it. For fills and images, Longer specifies a 0.06 or 0.09 mm interval and the Atkinson, Stucki or Jarvis dithers; focus at 151 mm below the module (Pro) or 110 mm (Nano). This profile follows Longer's file and has not yet been tried on a real machine.

Import… reads a LightBurn table: .lbso file, .lbdev device profile or .lbzip settings bundle, or plain text with “speed offset” on each line. Export… saves it as .lbso. In Bernie Studio, the same table is in the device settings, collapsible Scanning offset section.

Galvo Lasers

A galvo laser (fiber, MOPA, UV, CO2 galvo) has no moving head: two mirrors steer the beam within the field of a lens (110 × 110 mm, 175 × 175 mm…). Settings › Devices › New › “Galvo fibre 110 × 110 mm”, or the Galvo laser box of a profile: the width and height become those of the field, Bernie's workspace.

K40 Laser (M2 Nano Board)

Experimental: written from the public description of the protocol and tried on a simulated board, not yet on a real K40.

“K40” CO2 lasers still fitted with their stock Lihuiyu board (M2 Nano, marked “6C6879-LASER-M2”; also M3, B2…) do not understand G-code: Bernie drives them directly through their board, over USB. Settings › Devices › New › “K40 (M2 Nano board)”, the catalog machine “K40 CO2 40 W (M2 Nano)”, or the K40 with stock M2 Nano board box of a profile. A K40 whose board has been replaced (DLC32, FluidNC…) speaks GRBL: choose the catalog machine “K40 CO2 40 W (GRBL, FluidNC, DLC32)”, or untick this box and choose the firmware.

Networked xTool

Experimental: written from the public documentation of xTool's protocols and tried on simulated machines, not yet on every real machine. Run a first job at low power, on a scrap piece.

xTool machines without a serial port for G-code (M1, M1 Ultra, P2, P2S, F1, F1 Lite, F1 Ultra, F2 Ultra), and the D1, D1 Pro, D1 Pro 2.0 and S1 over Wi-Fi, receive the whole job over the network and engrave it on their own (Mac, iPad, iPhone, Windows and Linux desktop app).

Cutters and Plotters

Experimental: written from the description of the HPGL and GPGL (Silhouette) languages and tried on simulated cutters, not yet on a real machine.

Bernie also drives cutters (adhesive vinyl, heat transfer vinyl, paper) and pen plotters, with no internet connection.

Placing and Framing

No-Go Zones

Parts of the bed where the laser must not fire: a clamp, a stop, the rotary sitting in a corner, the edge of the honeycomb… Each device has its own (device settings, No-go zones section; not for a galvo).

Multiple Lasers

A machine with several lasers — diode and infrared (LaserPecker LP4), dual head, modules selected by a T0/T1 tool — describes its heads in the device settings, Laser Heads section (G-code machines; not for a galvo or a K40). Preset… fills the list (diode and infrared of the LP4, tools T0 and T1); Add a Head creates one. For each:

Each layer chooses its head (Head, below the mode; its sub-layers keep the same one); the material library remembers it with the settings. During the job, Bernie turns the laser off, sends the head's commands, then engraves with its offset and power; at the end of the job the machine returns to the first head: framing and manual firing use it (put a visible head first, the diode rather than the infrared). No-go zones take the offset into account: the machine does not move through a zone the head must not enter. The LaserPecker LP4 from the catalog, and an .lbdev profile whose macros select the source (“Select … Laser”), come with their two heads. Custom G-code has {head} (name of the layer's head). Ruida machines with a dual tube: tubes are still chosen per layer (Tubes), from the Ruida window.

Engraving

Start (at the top of the panel) runs the checks then asks for confirmation, with the pre-flight warnings — for example a layer speed beyond what the laser can do: it would cap it without saying so. During the job: Pause, resume, speed and power overrides (“During the Job” section), Stop (⌘.). Home before each job (device setting, on by default for a machine with limit switches): each job starts with $H, so it starts from a known position, even after an interrupted job or a head moved by hand (no effect when starting from the current position). After an interruption, put the preview slider where to resume and use “Start Here”. You can also save the G-code (preview › G-code) or run an existing G-code file. During a job, the Mac does not go to sleep (the iPad keeps its screen on): sleeping would cut off the sending.

Hour Counter and Maintenance

Laser › Hour Counter and Maintenance… (also at the bottom of the Laser panel; in Bernie Studio: Laser panel › Tests and settings): for the active device, the work hours (jobs running), the firing hours (laser on), the number of jobs (stopped ones included) and the distance engraved, since commissioning or the last reset.

Camera

Laser › Camera… shows the image of the bed under the design, in its real place: to put a design on a piece that is already on the machine. Three sources: Head-mounted camera: for a camera fixed to the head, which moves with it and only sees a small area, check Camera Mounted on the Head and set the camera field of view (shorter side of the area seen, in mm). Alignment, once: with the laser connected, bring the head above a plate, Add Head Target (four coded markers around the head, on a new layer), engrave it without moving the head, then Align on Target. Then Update Image scans the selection (otherwise the whole bed): the head moves, stops, one shot at each position (“Shot 3 of 12”), then the shots are stitched under the design — each point comes from the shot where it is closest to the image centre. In Bernie Studio, the same section is in the Camera tab (webcam fixed to the head, laser connected in the Laser tab).

USB camera (the laser's), network camera (address of a still image or an MJPEG stream: IP camera, ESP32-CAM) or a bed photo taken with a phone, straight down and always from the same spot (fixed mount).

  1. Align Camera… (once, or after moving the camera). Automatic (default): Add the coded markers to the project (nine coded squares, on a fill layer), engrave them on a flat plate without moving it afterwards, then Take Image and Align: Bernie finds the markers by itself (at least 3 visible; those found are marked on the image) and aligns the camera. Manual: Add the 9 marks to the project, engrave these crosses, Take Image, then click the center of each cross in order (left to right, top to bottom). The accuracy is shown (under 1.5 mm: good alignment); with at least 6 points, lens distortion is corrected too. Save.
  2. Update Image: a new shot, aligned under the design. Opacity sets its transparency, Hide removes it. The image is never engraved. X / Y Offset fine-tunes its position without redoing the alignment, Image Width / Height (in %) corrects its scale around the bed center, Image Resolution sets its sharpness (automatic, 1, 2, 4 or 8 pixels per mm); Save Bed Image… keeps it as a PNG; Continuous Update takes a new image at regular intervals while the panel is open. When Panel Opens: nothing, Update Image or Continuous Update (aligned camera). Captures: size and weight of the last image, capture time (and average), possible rate, shots and failures — to judge a network camera or its Wi-Fi. Material Height: each workpiece thickness has its own alignment (the image of a thick piece is larger and shifted) — Add a Height…, place a piece of that thickness and align the camera on it; then pick the height of the piece on the bed. Export Alignments… / Import… carry them to another computer, with the lens calibration (distortion, mean error, number of shots and date, shown in Calibrate Lens…). Brightness, Contrast and Saturation lighten the image or make the workpiece stand out under the design (the image is never engraved).
  3. Insert Image Into Project: the aligned image becomes a project image (covering the bed), to trace or engrave.

Analyze the Result (Camera panel, or Laser › Analyze the Result (Camera)…; Bernie Studio: Camera tab): after the job, update the image (or choose a photo of the bed); Bernie compares it with what the job was meant to engrave, for the whole job or only the selection. The comparison image shows the photo and, in red, the expected outline. The findings: similarity and contrast (dark or light marks), engraving offset (to 0.1 mm, within the image's precision), engraving offset from the cuts (the part moved), wrong size in X or Y (steps per mm), skewed result (gantry out of square), regular bands with their pitch (pulley, belt, bearing: a 20-tooth GT2 pulley travels 40 mm per turn), uneven tone and the stronger side (focus), fill that did not mark. Each finding gives its likely cause and opens My Job Is… on that symptom. If the job was placed correctly, Realign the Camera Image corrects the image offset (the panel's X and Y Offset).

Several cameras: the panel's Manage menu adds a camera, renames or deletes it; each one keeps its source, its alignments and its image settings. Link to Device puts it in use by itself when that device becomes active. The Cameras list (as soon as there are several, or while the camera is not aligned) shows each one's status: Source set, Aligned, Image received (camera in use) — a red dot is fixed with a click (camera choice, alignment, diagnosis); a click on the name puts the camera in use. Global image: a camera's eye includes it in the global bed image; with at least two cameras included, Update Image takes one image per camera, maps it with its own alignment (for the current material height) and overlays them — to cover a large bed with several cameras. A camera without an image or alignment is reported and skipped; a bed photo only serves the camera in use.

USB camera: Resolution (automatic, 720p, 1080p, 4K; changing it requires realigning) and warm-up frames (skipped when the camera opens while the exposure settles: more if the image comes out dark). Keep the last image between sessions puts the bed image back under the design when a project opens, without a new capture. Forget the Alignment for This Height removes an alignment that has become wrong. Interpolate Between Aligned Heights (on by default): a height without an alignment gets one computed from the two nearest aligned heights (marked “interpolated”). No Image? Diagnosis… checks the permission, the cameras seen by macOS, the chosen camera, the alignment and the last error, with what to do (Bernie Studio: secure page, site permission, cameras seen). Choose a Lens… (also Help › Camera Selection Help…) computes the field of view needed to see the whole area from the camera height, and checks a camera from its stated angle (diagonal, width or height): area seen and sharpness in pixels per mm. Calibrate Lens… (wide-angle camera): Add Target to Project (nine coded markers over 160 × 120 mm), engrave it on a flat, rigid board, place it at various spots in the camera's view (corners and edges especially), taking an image each time, then Calculate: four correction models are computed — Simple (most webcams), Extended (strongly distorting wide angle), Fisheye (real fisheye lens only), No correction (camera that straightens its own image) —, each with its mean error; the recommended model is selected for you. The preview shows the latest shot straightened under a straight grid: choose the model that makes straight lines straight, especially in the corners, not necessarily the smallest error. Each shot's error is shown; a shot clearly worse than the others is flagged “retake” and can be removed. After Save, the model is kept for this camera. Later alignments only have to place the image, which is more accurate at the edges. Redo it only when changing the lens or the resolution.

The camera is used only when you ask (one image at a time); macOS asks for permission the first time.

Which camera? A UVC-compatible USB camera (recognized without a driver), fixed above the bed so it no longer moves: wide-angle lens to see the whole bed, 1080p or more. The higher and more centered it is, the less the image is distorted. Without a camera: a phone photo, always taken from the same spot (fixed mount), gives the same result for placing a design on a piece.

Projector

A projector fixed above the bed shows the job's paths on the workpiece, light on black: to place the workpiece in the right spot or check a design before engraving. View › Projector… (Mac; More menu on iPad and iPhone; View › Projector… in Bernie Studio and the desktop app).

Laser menu › Print & Cut… (⌥⌘0): cut around a design that is already printed, run a second pass over an incomplete cut, resume an interrupted job or cut a large project in several parts. The laser must be connected and homed (it reports its head position); always move it with the keyboard or the panel, never by hand.

  1. Targets: two elements of the project, as far apart as possible, that exist identically on the sheet or the workpiece. Use Selection keeps the two selected objects (or groups); Add Registration Crosshairs places two crosshairs at the corners of the selection (or project) on tool layer T1, never engraved: print them with the design. For a second pass, place two small crosshairs on sharp corners of the existing cut.
  2. Head position: for each target, Go There brings the head where the target is in the project; adjust with the pad (steps of 0.1 to 10 mm) until the pointer is at its center, then Save Position. With an aligned camera, Locate on the Camera Image takes a new image of the bed and finds both crosses on it (sharp lines, sheet turned 15° at most, within 25 mm of their place in the project), without moving the head; a cross that is not found is recorded with the head. Accuracy depends on the camera (often a few tenths of a mm). With a camera mounted on the head and aligned (see Camera), Locate with the Head Camera replaces this button: the head brings the camera over the first target, where the project places it, finds the cross there, then centers on it to record it at the center of the image; it then moves on its own to the second, looked for where the first one, once found, places it. A cross that is not seen is looked for all around (eight shots in a ring); if it still cannot be found, bring the camera over it with the pad, then Search Here. Stop interrupts the search. A corner or an edge of the printed design next to a cross is not mistaken for it.
  3. Align Output to Targets: the whole project (locked objects included) is moved and rotated so that the targets land on the saved positions, and the start switches to absolute coordinates; a single action to undo. The measured scale is shown (beyond a 2 % difference, check the print scale); Apply Measured Scale applies it too.

Center of a round workpiece

Laser menu › Find the Center of a Workpiece…: bring the pointer onto the edge of the workpiece at three well-separated points (in any order) and save each position. Bernie computes the center and the diameter (also for a square — three corners —, a hexagon or an equilateral triangle), then, as you choose:

Rotary

Laser menu › Rotary… (⇧⌘R): rollers or chuck, axis (Y, Z or A), distance per turn, diameters. The height of the design becomes a rotation of the object; “Test” makes one turn.

Controller

GRBL: Controller Settings ($$) — read, edit (a backup is made before each write), save and restore; the manufacturer settings (motor wiring and direction, inverted signals, steps per mm, homing, grblHAL extended settings) are collapsed: expanding them first shows a warning, since a mistake can stop the machine from moving or make it grind against its stops; Calibrate an Axis — corrects the steps per millimetre from a measured distance. Console: exchanges with the controller, command entry, “Show all” to also see status reports. Macros: command sequences in one click. Each can have a keyboard shortcut: ⌥⌘1 to ⌥⌘9 on Mac and iPad (edit the macros › Shortcut; Laser menu › Macros), Alt + a letter or digit, or F2 to F10, in Bernie Studio (✎ on the macro, then press the keys in the Shortcut field). A shortcut runs only one macro.

Settings compared with the profile: at each connection, Bernie compares the settings read ($$) with the device profile — maximum power ($30), laser mode ($32), travel ($130, $131), speeds ($110, $111), accelerations ($120, $121), junction deviation ($11). The Laser panel reports the differences; Show… details them: Align the Profile with the Machine copies these values into the profile, Enable Laser Mode writes $32=1. Bernie also remembers the settings of the previous connection: a setting changed since then (firmware update, other software) is reported, and Restore Previous Values writes them back (after a backup).

In Bernie Studio: Laser panel › Controller settings… — the same differences and fixes, the editable list of settings (manufacturer settings behind a warning), Save settings… and Restore settings…; the automatic backup and the reading of the previous connection are kept in the browser. Calibrate an axis… is also in the Laser panel.

Files

Useful external tools: box and joint generators (Boxes.py, MakerCase…), foldable templates (Templatemaker…), gears, puzzles or mazes, single-line fonts (SHX, “single line” fonts) and vector image banks: export as SVG, DXF or PDF, then import into Bernie (fold lines in another colour land on their own layer).

Example Projects

File › New from Example… (iPad: “More” menu; iPhone: Project tab) opens a gallery of 81 projects ready to engrave and cut in plywood: Christmas, Halloween and Easter ornaments, baby gifts, jewelry, bookmarks, coasters, keychains, name plates, place cards and plant markers.

Layered Panel

File › New Layered Panel… (iPad: “More” menu; iPhone: Project tab) turns a picture into a plywood panel made of layers glued one on top of the other: each tone of the picture becomes a layer, cut from its own sheet, with a frame; the last one is the back plate.

  1. Picture: a logo or a drawing with flat colors, or a photo (smoothed, then reduced to a few tones). Transparent parts go to the back.
  2. Panel: number of pieces (back plate included, 6 by default; at most the number of tones in the picture), width or height (the other follows the picture), plywood thickness, your laser; Swap front and back puts the dark tones in front.
  3. Cutting rules, in mm whatever the size: frame width (by default 5% of the shorter side, 5 to 10 mm), thinnest part kept, smallest loose piece, gap between pieces laid out on one sheet. What the rules remove shows in red: make the panel bigger, lower the rule, or join those parts to the layer behind.

Layers: the Assembled preview shows the finished panel; click a part to select it (a whole layer from the list). Join moves the selected parts to the layer behind (or to the furthest back of the selected ones), Delete sends them to the back; the arrows move a layer forward or back (the back plate stays at the back). Undo and Back to the start take these changes back. The Pieces to cut preview shows each piece flat: wood held by the frame, loose pieces (orange), removed parts (red).

Create the project: All on one sheet (pieces side by side; those that do not fit on the bed go to a next sheet) or One piece per page (one page per piece, see Pages); on Mac, in Bernie Studio and the desktop app, a new project, on iPad and iPhone, the empty project. Cut and Light score layers set for your laser. Loose pieces (not held by the frame) are glued onto the piece behind, where a light score line marks their place; the gluing order is marked on each frame (1 = back plate), hidden by the piece glued on it. Run a material test first.

Pages

A project can have several pages: a workspace each, with its own objects — the top and bottom of a box, one sheet per customer, several tests side by side. Layers, output settings, notes and guides are shared by all pages.

Web Tools

The Web Tools menu opens online generators: finger-joint boxes (Boxes.py, MakerCase), packaging templates (Templatemaker) — and your own. On Mac, iPad and iPhone, and in the desktop app, the tool opens in a Bernie window: the file it downloads (SVG, DXF, PDF, image) goes into the frontmost project. This window stays on the tool's site (other links open in the browser), and your own tools open in the browser: then import the downloaded file. In Bernie Studio (browser), the tool opens in a new tab: then import the downloaded file (File › Import, or drag it onto the workspace).

Manage Web Tools…: add your tools — name, address (https://, added if missing), category (menu subtitle; empty: “My Tools”) — or remove them.

Extensions

An extension adds commands to the Extensions menu: generators, which create shapes from their parameters (a gear from its number of teeth and module, a grid of holes…), and filters, which replace the selected shapes (turning an outline into dashes…). It is a .wasm file that Bernie runs in isolation: it only sees the parameters and shapes it is given, with no access to your files or the network, and it is stopped if it computes too long or asks for too much memory.

In Bernie Studio, the desktop app (Windows, Linux) and the Mac downloaded from the website; not in the App Store apps (Mac, iPad, iPhone), whose rules forbid adding features through a file.

Installing: Extensions › Manage Extensions…, then Install an Extension… (.wasm file), or one of the examples (Gear, Hole grid, Dashes). An installed extension is kept for later projects; its checkbox disables it without removing it; an extension with the same name replaces another (update).

Running: each command has its parameter window (the last values used are kept). A generator places its shapes in the center of the view, grouped; a filter replaces the selection and keeps its layers. A single action to undo. If the extension refuses (impossible parameters, nothing selected), its message is shown and nothing changes.

Preferences

Where to find them: on Mac, Bernie › Settings… (⌘,); on iPad and iPhone, Preferences… in the Document section of the inspector. In Bernie Studio (browser and desktop app), the window takes the look of the system: on Windows, File › Settings (Ctrl+,); on Linux, Edit › Preferences (Ctrl+,); on Mac, Bernie Studio › Settings… (⌘,). Pages General (language, text size, window already running in the desktop app), View (rulers, filled display, fast outlines), Edit (snapping, mouse gestures), Privacy (statistics) and More settings (device, settings bundles, shortcuts). The settings detailed below are those of the Mac and iPad app; in Bernie Studio, the others are in their place in the menus and panels.

Usage statistics: to learn which features are used and which cause trouble, Bernie sends anonymous statistics — tool chosen, format imported or exported, start and end of a job (rounded duration), laser connection (controller, USB or network), panel opened, errors. Never a file name, project content or anything that identifies you; the full list is in the repository (docs/telemetrie.md). To turn them off: Settings › General › Usage Statistics (Bernie Studio: Privacy page of the settings, or checkbox in the manual window). From the App Store (Mac, iPad, iPhone), Bernie asks you once, at launch: nothing is sent before Share.

Updates: through the App Store (Mac, iPad, iPhone), which announces and installs new versions; the TestFlight version updates through the TestFlight app. In Bernie Studio, a large banner offers to reload the page when a new version is online.

The Settings pages (General, Editing, Display, Laser, Automation, Backup) gather: language, design units (mm or inches), speed units (per second or per minute; Bernie Studio and the desktop app: Preferences › General › Units), arrow-key nudge, click tolerance, snapping distance, return to the Select tool after drawing, import (group, center, select, keep shapes in T1 and T2 colors on the tool layers), ignore shapes outside the work area, “Selection Only” and selection origin when opening and saving them with the project, error sound if sending fails (job refused, controller error or alarm, sending to a Ruida controller), filled display, zoom direction; display: theme (system, light, dark), interface text size (small, normal, large, extra large: window text and controls; Bernie Studio: “Text” list at the top of the page), dark bed, grid contrast, cross at the center of the bed, full-view crosshair cursor, handle and node size, reduce motion (no blinking or animated scrolling; adds to the system setting), fast outline display (less fine, smoother on a very busy design; the engraved path does not change), large tool icons, numbers on the color strip; text: font and height of new texts, typing window on double-click, SHX fonts folder; export and import of preferences; Factory Settings… (after confirmation) resets display, editing, windows, shortcuts, import, sending and tools to their original settings, keeping devices, libraries, presets, calibrations, language, the link to the laser, access codes and your choice for usage statistics. Settings › Shortcuts: see Keyboard Shortcuts.

Settings bundles (Settings › Backup): Export a Bundle… gathers, as you choose, preferences, shortcuts, image presets, devices, macros and material libraries into a .bernielot file — to move to another computer or keep a copy; Import a Bundle… shows its content (devices included) and takes the checked components; items whose name is already taken (devices, macros, presets, libraries) are listed, then replaced, both kept (the imported one gets a numbered name, “Name (2)”) or not imported, as you choose; the rest is added. Automatic backups: Bernie saves these settings at each launch and when quitting, if they have changed (50 backups kept); Automatic Backups… lists them, with the devices of each, and restores one (the current state is backed up first). Open the Settings Folder shows in the Finder the folder of devices, macros, libraries and backups. In Bernie Studio: Device › Settings bundle… exports and imports devices, macros and material libraries (same format: a bundle moves from the app to the browser and back), and Open… also accepts a .bernielot, such as a manufacturer bundle.

Settings shared between computers (Settings › Backup, Mac and iPad): so that several computers or users keep the same devices, material libraries and macros. Choose a Folder… keeps a common folder (network drive, iCloud Drive, synced folder); check what is shared (by default devices, libraries, macros and image presets — not your personal preferences). Publish My Settings writes a bundle there (Bernie-reglages-partages.bernielot); on the other computers, Apply at launch when they have changed applies it on its own when Bernie opens (or Apply Now): items with the same name are replaced, the rest is added, nothing is deleted, and an automatic backup is made first. Stop Sharing forgets the folder; Factory Settings… keeps it. In Bernie Studio and the desktop app: Device › Settings bundle… › Settings Shared Between Computers (devices, macros and material libraries, same bundle as the app: Macs, PCs and browsers share the same folder); in a browser, Chrome or Edge only, and applying at launch requires access to the folder to have been granted already (otherwise Apply Now).

Layout (Window menu): show or hide the tool bar, the side panel (⌃⌘S), the colour strip and the status bar; Positions: tool bar on the right, side panel on the left, editing bars below the canvas, colour strip at the top; Reset Layout puts everything back (also by holding ⇧ at launch). Laser Panel in a Window (Mac): the Laser panel detaches into its own window, to place anywhere (on a second screen, for example); it drives the project in front and the side panel keeps only the layers. Closing it (or unticking the entry) puts it back in the side panel.

Reset Bernie (Settings › Backup; on iPhone, in the project; in Bernie Studio, Other Settings): Bernie goes back to its first launch. Preferences, devices, macros and connections go back to zero, then the assistant opens: the Mac restarts, the browser reloads the page, iPad and iPhone stay open. Reset keeps your material libraries, templates, job log and hour counters (and, on Mac and iPad, a backup of your settings); Erase Everything removes them too. Your project files are never touched; the language and your statistics choice are kept. On Mac, open projects first offer to save their changes; in Bernie Studio, the open project closes without being saved.

Share the Laser (Hub Mode)

The Mac connected to the laser can share it with other devices on the local network (iPad, Bernie Studio): they see the laser's state and progress, send a job, pause it or stop it.

Desktop app (Windows, Linux): laser connected over USB, Laser panel › Connection › Share This Laser on the Network (Hub Mode)… (after the question; off by default). The PC becomes a Bernie Link: it serves Bernie Studio to the browsers on the network (http://<PC address>:46490/, shown with the pairing code), announces itself on the network and keeps the job queue; every start is confirmed on the device that sends it, and this PC keeps control (pause, stop, removing any job from the queue). Stop Sharing gives the port back to the app. Allow Bernie on the private network if the system asks.

The Pairing Code

To connect to a shared laser, a device must enter its pairing code: 8 characters, without 0, O, 1, I or L. Without it, Bernie Link and the Mac refuse everything (laser state, job, moves), and the assistant goes no further. The device then keeps it: you only enter it once, and Forget This Code erases it (assistant, Laser panel).

Where to find it, depending on what shares the laser:

The code stays the same from one start to the next, power cuts included. After 8 wrong codes in a row, Bernie Link picks a new one: read it again the same way; devices already paired will have to enter the new one.

Bernie Link shares the laser without a Mac switched on next to it: a small computer placed near the machine (Raspberry Pi, old PC running Linux or Windows) runs the bernie-hub service, with no interface. Devices connect to it as they would to a Mac sharing its laser — same pairing code, local network only — but since there is no screen, each start is confirmed on the device that sends the job.

Assistant (MCP)

An assistant such as Claude can prepare your projects through the MCP protocol: add shapes, texts, QR codes and barcodes, set layers (mode, speed, power, passes, interval), import an SVG, move, rotate, group, check the job, export as SVG, DXF or G-code and look at the preview image. Every change is one action to undo (⌘Z). The assistant never controls the laser: you start the job yourself in Bernie.

Automation (UDP)

A workshop script (or other software) can drive Bernie with LightBurn's UDP commands — open a project, import a file, choose the device, read the state — but authenticated: each message starts with a token (LightBurn requires none).

bernie Command

Bernie without a window: from a terminal or a script, the **bernie** command checks, estimates, exports and engraves a .bernie project with the same preparation as the app (device, check before sending, no-go zones, variable text). It ships with Bernie Link (installed as /usr/local/bin/bernie by the installer, bernie.exe in the Windows archive).

Projects sent to Bernie Link: POST /hub/v1/project (.bernie file as the body, ?serial= for the variable text counter) has Bernie Link prepare the job with the device it keeps; the job then waits for its confirmation like the others. Details and examples: docs/API.md.

Safety

Troubleshooting

Share Feedback (Feedback menu, always in the menu bar, ⌃⌘A on Mac; iPad: ⋯ button; iPhone: Help tab, top-right button; Bernie Studio and the desktop app: Feedback menu): pick the type — Suggestion (and where in Bernie), Bug (severity, frequency), Share a success, Other —, sum it up in one sentence, add details if you like, then Send: the Bernie team is notified right away. Optional attachments: Capture the Window (the project window, without the feedback window; in Bernie Studio, the project preview), Add a File… (10 MB at most), the technical details (version, system, laser — shown before sending) and, for a bug, the session log. Your email is optional, only to reply to you. Offline, or if the service does not answer, the feedback waits in Bernie and is sent at the next launch (or with Feedback › Send Waiting Feedback); Send by Email… also lets you send it yourself. Nothing is sent without your click, never your designs unless you attach them, and nothing is used for anything other than improving Bernie. On Mac, iPad and iPhone, I agree to send this feedback must be turned on before sending: the feedback goes to Bernie's server (bernie.websolutis.com), read only by the team.

Damaged or oversized file: an imported file that is unreadable in places is read as far as possible; items with absurd coordinates (more than a kilometre, infinite values — damaged file or wrong unit) are ignored with a warning (“oversized item(s) ignored”). Very large designs (tens of thousands of shapes) stay smooth: selection, preview and G-code are computed in under a second for a hundred thousand small shapes, and a selection of twenty thousand shapes drags smoothly with the mouse. A shape too large to be filled (more than 200,000 scan lines, i.e. 20 m at a 0.1 mm interval) is not filled, and the pre-flight check reports it.

Debug Drawing (Help menu, at support's request): bounding box of each shape and technical data at the top left of the workspace (objects, zoom, view, display tolerance, segments, history). Debug log from launch (for a crash at startup): open -a Bernie --args -debug YES turns on the communication log for this session and first writes the version and system into it; Bernie Studio: add ?debug=1 to the address (debug drawing from loading).

Support Data… (Help menu): a text file to attach to a request for help — version, system, device profile, connection state, recent jobs, the end of the console and, if turned on (Settings › Laser), of the laser communication log. No project and no password. In Bernie Studio: Support data… button of the help window (browser, device, connection, recent jobs, end of the console). Convert to Cut (Debug) (Help menu): the paths the laser would follow for the selection become a path on tool layer T2 (never engraved), to understand an unexpected result.

History… (Edit menu): the list of actions done and undone; one click brings the project back to that state. In Bernie Studio: History… button next to Undo and Redo.

My Job Is… (Help menu, or “Disappointing result?” in the Laser panel): pick the symptom (mirrored, shifted, wrong size, ghost edges, burnt corners, too faint, missing shapes, wrong time…), answer one or two questions, and Bernie gives the likely causes with the tools to fix them: device orientation, scanning offset, controller settings compared with the profile, material test, axis calibration, preview. The laser does not connect, or does not respond: port missing from the list (cable, power, USB-C, driver), port busy with other software or misconfigured, machine in alarm or silent, connection dropping (interference, ground, power supply), network laser not found — the usual causes, from the simplest to the rarest. In Bernie Studio, Help › My job is… offers the same path, with the same tools.

SymptomLead
Nothing is engravedLayer sent to the laser (bolt)? Power not zero? Closed shapes on a fill layer? See the pre-flight check.
The job leaves the work areaAbsolute coordinates: the design must be on the bed; reduce overscan or speed.
Darker edges on fillsTurn on automatic overscan.
Every other line shiftedSet the device's scanning offset.
Engraving mirrored or upside downLaser › Check Device Orientation.
Engraving upside down or mirroredCheck the machine origin in the profile.
Power too strong or too weakProfile S max equal to the controller's $30.
The laser stays on between shapesTurn on laser mode ($32=1) or tick “GRBL without laser mode”.
Wrong estimated timeEnter maximum speeds and accelerations (“Read from the connected laser”).

Bernie Studio (browser)

Bernie Studio is Bernie in a browser, on the same core as the Mac app: drawing, layers and their settings, images, preflight check and G-code are identical.

Bernie Studio shortcuts (⌘ on Mac, Ctrl elsewhere):

ShortcutAction
V, R, E, P, L, T, N, X, MSelect, Rectangle, Ellipse, Polygon, Path, Text, Nodes, Trim, Measure tools
⌘Z, ⇧⌘Z (or ⌘Y)Undo, redo
⌘X, ⌘C, ⌘V, ⇧⌘V, ⌘DCut, copy, paste, paste in place, duplicate
⌘A, ⇧⌘ISelect all, invert selection
⌘G, ⇧⌘GGroup, ungroup
⌘L, ⇧⌘LLock, unlock
⇧⌘], ⇧⌘[Bring to front, send to back
⌫, arrowsDelete, move the selection
⌘S, ⌘O, ⌘I, ⌘ESave, open, import, export G-code
⇧⌘PJob preview
?, F1Keyboard shortcuts

Bernie for Windows and Linux

Bernie desktop is Bernie Studio in an application window, for Windows, Linux (and macOS): same drawing, same layers, same preflight check and same G-code as in the browser, without depending on Chrome or Edge.

Keyboard Shortcuts

You can change shortcuts in Settings › Shortcuts (on iPad: Preferences › Keyboard Shortcuts):

Default shortcuts:

ShortcutAction
V, R, E, P, L, T, N, X, MSelect, Rectangle, Ellipse, Polygon, Line, Text, Nodes, Trim, Measure tools
I, S, C, B, FNode tool: insert, smooth node, corner node, break path, close path
L, S, A, T, ENode tool, segment under the pointer: straighten, smooth curve, align, trim, extend (they take priority over the tools while editing nodes)
Tab, Shift-TabNext, previous object
⌘Z, ⇧⌘ZUndo, redo
⌘X, ⌘C, ⌘V, ⌘DCut, copy, paste, duplicate
⌥⌘VPaste in place
⌘ASelect all
⇧⌘IInvert selection
F1Help on what you are doing
⌘G, ⇧⌘GGroup, ungroup
⇧⌘H, ⇧⌘VFlip horizontal, vertical
⇧⌘AArray
⌘L, ⇧⌘LLock, unlock
⇧⌘], ⌘], ⌘[, ⇧⌘[Bring to front, bring forward, send backward, send to back
⌫Delete the selection
Arrows (Shift: large step)Move the selection
⇧⌘KInsert a code
⌘IImport
⌘E, ⇧⌘EExport G-code, export SVG
⌥⌘U, ⌥⌘-, ⌥⌘IUnion, subtract, intersect
⌥⌘OOffset path
⌥⌘P, ⌥⌘BConvert to path, break apart
⌥⌘J, ⌥⌘DRebuild curves, delete duplicates
⌥⌘TTrace image
⌥⌘LMaterial library
⇧⌘RRotary
⌘=, ⌘-, ⌘0, ⇧⌘0Zoom in, out, show the bed, show the selection
⌘', ⇧⌘'Snap to objects, to the grid
⌥⌘FFilled display
⇧⌘PJob preview
⌘.Stop the laser
⌘,Settings
⌘RShow or hide the rulers
⌥⌘ arrowsMove the laser head by one step

No results.