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).
- xTool D1 and D1 Pro: their firmware, close to GRBL but without status reports, is recognized when connecting; Bernie reads the position, works out the state and sends one line at a time. The original D1 joins the catalog, the D1 family at 230,400 baud, a speed now offered everywhere — see Devices.
- Wi-Fi lasers that don't announce themselves: Search the Network also finds GRBL boards on ports 23 and 8080 (MKS DLC32, many ESP32 boards); an address without a port tries 23 then 8080, and a failed connection says what to check (port, other software connected, local network access) — see Connection.
- Cutters and plotters: Knife tool (blade offset, swivel in corners, overcut), HPGL vinyl cutters over the serial port and
.pltfiles, "Cutter / plotter" choice in the Bernie tour — see Cutters and Plotters. - Print & Cut with the head camera: a camera mounted on the head moves on its own over each registration cross, finds it and centers on it — see Print & Cut.
- Layered panel: from a picture to a plywood panel of glued layers, one layer per tone, cutting rules in mm, loose pieces marked for gluing — see Layered Panel.
- Example projects: 81 projects ready to engrave and cut (ornaments, jewelry, coasters, keychains, place cards…), set up for your laser, with your own text — see Example Projects.
- Resuming after a power cut: an interrupted job (power cut, computer switched off, laser unplugged) is offered for resuming, at the point where it stopped; in Bernie Studio and the desktop app, the preview now has its time slider and “Start Here” — see Engraving.
- Extensions: commands added by extension files — shapes generated from parameters (gear, hole grid…) or processing of the selected shapes (dashes…); in Bernie Studio, the desktop app and the Mac downloaded from the website — see Extensions.
- Parametric sketches: shapes defined by constraints (parallel, tangent, symmetric…) and dimensions, which recompute when a value changes, and project parameters (
width = 10 * thickness) that dimensions can refer to — see Parametric sketches. - Web tools in the desktop app: as on Mac and iPad, a tool's window stays on its site, and your own tools open in your browser — see Web Tools.
- Pairing code required for a shared laser: the assistant no longer goes further without it; it used to suggest a connection when nothing was connected. Where to find it on Linux, Windows or a Mac: see The Pairing Code.
- The whole Ortur and Aufero range in the catalog, older models included; Bernie reads the model name from the controller and explains the alarms of recent controllers (emergency stop, homing required, shock sensor) — see Devices.
- K40 with a replaced board, custom machine: the catalog also has a K40 with a GRBL board (DLC32, FluidNC…), and the assistant offers Custom Machine and a choice of Controller at the “Your machine” step. Export This Profile… and Import a profile are easy to find in the device settings, and Bernie Studio can now export a profile too — see Bernie tour and Devices.
- Reset Bernie: in the settings, back to the first launch, then the assistant — see Preferences. Add a Laser… starts the assistant from the Laser menu, the Help menu and the Laser panel — see Bernie Tour. On Mac and iPad, the settings are now organized in pages.
- 3D Simulation is clearer and quicker to reach: a 3D button next to the eye, lines that stay visible even on a large piece, and on Mac the simulation follows the project as it changes — see 3D Simulation.
- Longer Nano and Nano Pro in the machine catalog: a diode galvo driven with G-code, over USB or Wi-Fi, with the manufacturer's macros. Carving mode switches on by itself when you connect, thanks to the new device setting Commands on Connect — see Devices.
- Automatic updates: Bernie Link updates itself every night, never during a job (options and pairing code kept); on Linux, the AppImage desktop app announces the new version and installs it in one click. Every update is signed: a modified file is never installed — see Bernie Link.
- Spanish, Italian and German: Bernie now speaks five languages — Mac, iPad and iPhone apps, Bernie Studio, the desktop app, Bernie Link messages and this manual; choose the language in the app's Settings (Interface language) or in Bernie Studio's Preferences — see Preferences.
- 3D simulation: the job in 3D, the workpiece carved and darkened over time, the head and its beam; playback, time slider, speed, material, laser power, thickness, exaggerated relief — see 3D simulation.
- 3D models: an STL, OBJ, 3MF, PLY, OFF or AMF model becomes a depth map, engraved in relief (grayscale, or in slices on a galvo); the side facing the laser, tilts, size and relief are set with a preview — see 3D models.
- Preferences in Bernie Studio, on Windows and on Linux: a window with the look of the system (File › Settings on Windows, Edit › Preferences on Linux, Ctrl+,) gathers language, text size, display, snapping, gestures and statistics — see Preferences.
- Centerline: trace an image along the middle of its strokes (line logo, sketch, handwriting) rather than as outlines — see Images.
- Multi-page projects: each page has its own objects, layers and settings are shared; the job engraves the page shown — see Pages.
- Web tools: online generators (Boxes.py, MakerCase, Templatemaker, your own) opened in Bernie, the downloaded file goes into the project — see Web Tools.
- Multiple lasers: a machine with several heads (diode and infrared of the LaserPecker LP4, dual head, tools T0 and T1) describes its heads; each layer chooses its own, with its offset and power — see Multiple Lasers.
- Projector mode: a projector above the bed shows the job's paths on the workpiece, calibrated with four markers — see Projector.
- **
berniecommand**: check, estimate, export and engrave a project from a terminal or a script (laser over USB or the network, Bernie Link, OctoPrint, Duet); Bernie Link also prepares a.bernieproject sent to it — see bernie Command. - OctoPrint and Duet: new Server connection mode — the job goes as a file, framing, pause, resume and stop — see Connection.
- No-go zones: parts of the bed where the laser never fires — or where the head does not go at all (tall clamp, stop) —, hatched in red; a job or framing that would touch them is refused — see No-Go Zones.
- Hour counter and maintenance: work and firing hours of each device, and maintenance reminders (clean the lens, change the water…) — see Hour Counter and Maintenance.
- Macro shortcuts: a macro runs from the keyboard (⌥⌘1 to ⌥⌘9 on Mac and iPad, Alt + a letter or digit or F2 to F10 in Bernie Studio) — see Controller.
- LaserPecker LP2 Plus, LP4, LX1, LX1 Max and LX2 (driven in G-code over USB, with the manufacturer's macros) and Makera Carvera Air (laser module) in the machine catalog; an imported
.lbdevprofile also keeps its origin corner and speeds — see Devices. - K40 laser with its stock M2 Nano board (experimental): driven through its board, over USB, without replacing it — see K40 Laser.
- Bernie Link in one line:
curl -fsSL https://bernie.websolutis.com/link/install.sh | sudo shinstalls the shared laser on a Raspberry Pi or a Linux PC — see Bernie Link Without a Screen. - Downloadable art libraries: four libraries of original drawings published on the Bernie website (shapes, frames and labels, patterns, marks and templates), installed in one click — see Editing Shapes.
- Settings shared between computers (Mac, iPad, Windows, Linux, Bernie Studio): a common folder where one computer publishes devices, libraries and macros, applied at launch by the others — see Preferences.
- Print & Cut with the camera: both registration crosses are found on the camera image, without bringing the head onto each — see Print & Cut.
- Opening a file from the system (Windows, Linux): double-click a
.bernieproject or a.bernielotbundle, opened in the Bernie window already running (adjustable) — see Bernie for Windows and Linux. - Lens correction model: lens calibration computes four models (simple, extended, fisheye, no correction) with their error and each shot's, and shows the latest shot straightened so you can choose the one that makes straight lines straight — see Camera.
- Feedback menu: share a suggestion, a bug, a success or a question in seconds, window capture included; offline, the feedback waits in Bernie — see Troubleshooting.
- Five more barcodes: EAN-8, UPC-E, Code 93, Codabar and Interleaved 2 of 5 (ITF-14), checked with a reader — see Text and Codes.
- Organizing and restoring your settings: the art library can be reorganized (rename or delete a library, move a drawing, replace it with the selection) — see Editing Shapes; when importing a settings bundle, items already here are replaced, both kept or left out, as you choose; Factory Settings… asks for confirmation and keeps devices, libraries, language and your usage statistics choice — see Preferences; the lens calibration travels with the camera alignments — see Camera; Node tool: S on a straight segment turns it into a smooth curve — see Drawing.
- Bernie tour (Mac, iPad, iPhone, Bernie Studio, Windows and Linux): at first launch, an animated tour introduces Bernie and sets up your laser — laser type, search over USB and the network or the catalog, work area and origin, material library, then a first project (material test, sample project with the Bernie logo or blank page). Open it again from Settings › General and the Help menu — see Bernie tour. It continues with an interface tour: a bubble shows the tools, the workspace, the layers, the Laser panel and the status bar — see Interface tour.
- Material libraries by machine: over 1,800 starting settings for 13 machines and collections (Creality Falcon2, Elegoo Phecda, Snapmaker Ray, xTool D1 and D1 Pro, 80 W MOPA and Gweike G2 Max fibers…), added and linked to the profile when the machine is chosen from the catalog (Falcon2, Ray, D1 Pro); importing
.clblibraries now also keeps frequency and pulse width, Z settings, ramps and wobble — see Material Library and Test. - Larger device catalog: Emblaser, Snapmaker (2.0, Artisan, Ray) and a G-code-driven MOPA source join the commercial machines, grouped by brand; depending on the machine, the profile brings the port speed, macros, start G-code and scan offset compensation. Import a profile also reads
.lbdevdevice profiles (one or more devices, with their macros). “Find My Laser” also tries 460,800 baud. Custom G-code:{freq}and{qpulse}variables for MOPA sources — see Devices. - Export for EZCad checked in EZCad 2.14.11: Bernie's files open in it; the pulse width, the jump delays and their limit length are now written (and read) where EZCad displays them; hatches keep their scan direction and angle (slanted ones used to arrive mirrored) — see Files.
- Older graphics cards: when the browser or Windows advertises WebGPU but cannot provide it, drawing uses WebGL2 instead of not showing at all — see Bernie Studio. Bernie Link also announces itself on the network on Windows — see Bernie Link.
- Network lasers on Windows and Linux: the desktop app also connects to Wi-Fi or Ethernet lasers (grblHAL, FluidNC, serial-to-Wi-Fi bridges), as on the Mac, and finds them on the network (Bonjour) — see Bernie for Windows and Linux.
- JCZ board (EZCad2): the marking list translated into board commands and read back by a virtual board — see Galvo lasers.
- Export for EZCad, continued: sub-layers (one pen each), offset fills as concentric outlines, engraving order, groups — see Files.
- EZCad pens: pulse width (MOPA) and end-of-path delay read and written by the
.ezdimport and export — see Files. - EZCad2 configuration (
markcfg): field, offset, mirrors, scales, corrections and frequencies read into the galvo device — see Galvo lasers. - Images in the export for EZCad: images go out in grayscale, adjusted and placed as in Bernie — see Files.
- Export for EZCad (
.ezd, experimental): layers as pens, fills as hatches, to mark with EZCad — see Files. - EZCad3 motors (
Motors.ini): linear table and A axis read into the galvo device — see Galvo lasers. - EZCad2 projects (
.ezd): shapes, hatches and pens of a galvo laser project imported with their settings — see Files. - Analyze the result with the camera: the photo of the result compared with the job — offset, size, skew, regular bands, uneven tone, missing engraving, with their causes — see Camera.
- Preview on a material: wood, plywood, cardboard, leather, slate, black acrylic, anodized aluminum — the engraving seen as on the part — see Preview.
- Galvo laser source: frequency and pulse ranges checked, MOPA, CO2, UV, SPI settings, second source per layer — see Galvo lasers.
- Galvo external axis: split marking of a design larger than the field, repeat marking in batches — see Galvo lasers.
- Galvo rotary: marking all around an object, slice by slice (whole shapes, order, overlap) — see Galvo lasers.
- Galvo live framing: frame that follows the selection, move, rotate and enlarge with the keyboard or buttons, frame before marking, pause — see Galvo lasers.
- Virtual galvo: simulated marking with piece counter, repeats, continuous run, stop at count, auto-rotate from one piece to the next — see Galvo lasers.
- Galvo lens calibration: nine-point pattern, orientation, computed corrections, larger field — see Galvo lasers.
- Cylinder correction (galvo): mark a cylindrical object lying flat, without a rotary — see Galvo lasers.
- Ruida dual tube: tube names, one tube at a time, second head offset — see Files.
- Commercial machines: starting profiles for common diode lasers (Atomstack, Creality, Ortur, Sculpfun, xTool D1 Pro) — see Devices.
- Ruida controllers: save the job in the controller's memory under a name (automatic numbering), controller information (card, version, counters), dual tube (tubes and powers per layer) — see Files.
- Scribe (diamond) as the device's tool, minimum power explained (corners on Ruida controllers) and RF tube for Ruida sending — see Devices and Files.
- G-code clustering (smoother image engraving on controllers that accept it) and custom G-code header (
G21/G20units, coordinates in inches, work coordinate system) — see Devices. - Vision markers AprilTag and ArUco among the codes — see Text and Codes.
- Controller templates: G-code for Duet / RepRapFirmware, Mach3 / Mach4 and UCCNC set in one go — see Devices.
- Galvo lasers (fiber, MOPA, UV): galvo device and virtual galvo — duration, marking image, framing —, beam wobble, per-layer timings, 3D sliced — see Galvo Lasers.
- Ruida controllers:
.rdimport and export, network sending, framing, stopping, connection test — see Files. - Camera: what the panel does when it opens; capture statistics; MJPEG streams read one image at a time (much faster) — see Camera.
- Anonymous usage statistics, can be turned off in Settings — see Preferences.
- Support Bernie… (Help menu): tips through the App Store — see Getting Started.
- Share Feedback… (Feedback menu, always in the menu bar): a suggestion, a bug, a workshop success or a question, sent to the Bernie team — see Troubleshooting.
- Share the laser (Hub mode): the Mac shares its laser with devices on the local network, each start confirmed on the Mac — see Share the Laser.
- Calibrate the camera lens from several shots of a target — see Camera.
- Global bed image: several cameras overlaid (the eye in the camera list) — see Camera.
- Bar positions (Window menu): tools on the right, side panel on the left, editing bars below the canvas, colour strip at the top.
- Camera: alignment interpolated between two aligned heights; device icon; reduce motion.
- EAN and UPC add-on codes (“+12”, “+12345”) with an adjustable gap; fast outline display; Convert to Cut (Debug) (Help menu).
- Rotary and images: tapered object (flared tumbler) — see Rotary; an image cut by a shape becomes two masked images; camera lens calculator; printed line width.
- Workshop: head moved with the numeric keypad and from machine zero, test legends perforated, batch image tracing (File), settings folder (Settings), needless Z moves removed.
- Shapes: dual star, tangent circles to three circles (Tools), grid with random orientation, Trim that keeps the removed segment (Shift-click) — see Drawing and Editing Shapes.
- Bake values of a variable text or code; rectangular Data Matrix and control characters (GS1) — see Text and Codes; Repeat Last Offset (⌘-click the offset button).
- Firing threshold: material test preset, twenty lines from 1 to 20 % — see Material Library and Test; adjustable network timeout for Wi-Fi or Ethernet lasers. Bernie Studio: material test presets.
- Custom G-code (continued): prohibited characters, escapes (
\xHH), controller error and alarm messages,{rotary_diameter}variable — see Devices; numbered copies along a path (variable text); error sound when sending fails. - Custom G-code: command templates for unusual controllers, with a preview — see Devices.
- Variable text: serial numbers, date and time, CSV merge, project counter — see Text and Codes.
- Camera: automatic alignment with engraved coded markers, found by themselves in the image — see Camera.
- Windows: Laser Panel in a Window (Window menu, Mac) — see Preferences.
- Cameras: camera list with their status (source, alignment, image) — see Camera.
- Network: Search the Network finds lasers that announce themselves (Bonjour) — see Connection.
- Fine nesting: rotations every 45°, 30° or 15°, several placing orders tried — see Editing Shapes.
- Camera: resolution and width / height of the bed image — see Camera.
- Controller: manufacturer settings collapsed behind a warning — see Controller.
- Layers: the layers “…” menu — output, visibility and air assist of all layers at once — see Layers.
- Interface: modes bar (Rotary, Print & Cut, Center) above the canvas, interface text size in the settings.
- Z axis and tabs: material height in the Laser panel, tab pulse width in the device profile — see Devices.
- Files: EPS import (paths and colors, Illustrator files included) — see Files.
- Machine: the Mac no longer sleeps during a job (the iPad keeps its screen on); Autofocus button for machines with autofocus (command in the device profile) — see Devices.
- Camera: resolution and warm-up frames, bed image kept between sessions, alignment to forget, No Image? Diagnosis… — see Camera.
- Virtual array: clones linked to the original that follow its changes; flatten or remove — see Editing Shapes.
- Fonts: single-line SHX fonts, Browse Fonts… with search and previews — see Text and Codes.
- Engraving and preview: flood fill, Why this line? (click the preview), PDF and Illustrator export — see Preview and Files.
- Editing: 16-point warp, Trim that welds the leftovers, right-to-left text, alignment assistant.
- Project and images: “Selection Only” remembered, inverted image display, Reload an edited image, threshold edge ramp, damaged projects partly opened.
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.
- Three steps: draw, set up (each color is a layer), engrave.
- 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).
- 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).
- 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).
- 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
- 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.
- 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.
- Set up the layers: each layer has its color, its mode (Line, Fill, Image), its speed and its power. See Layers.
- Check the preview (eye button): paths, estimated time, pre-flight check.
- 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
- Left bar: drawing and editing tools (letter in parentheses: keyboard shortcut).
- Canvas: the machine bed, with a grid. Scroll wheel or pinch to zoom, space bar (or two fingers) to pan. The green crosshair marks the head position when a laser is connected.
- Right panel, Layers tab: selection properties, layer list and settings of the chosen layer; Laser tab: connection, machine state, job, manual controls, console.
- Bars above the canvas: arrange (group, ungroup, align, distribute, place on the bed, rotate, mirrors) and modifiers (union, subtraction, intersection, offset, array). Buttons with an arrow (align, distribute, place) remember the last choice: a click repeats it, the arrow opens the list. On the right, the modes bar: Rotary (highlighted when the rotary is enabled; opens its settings), Print & Cut, Center of a round piece. Each bar can be hidden in the Window menu.
- Status bar (bottom): cursor position, zoom, selection (number of objects and extent), help for the active tool, connected laser and its state (click: Laser panel), last machine alert (click: clear it).
- Right-click (or Control-click) on the canvas: context menu for the selection.
- On iPad: the app's menu bar (File, Tools, Help) comes with a keyboard; by touch, the ⋯ (More) button of the top bar gathers Import, Export (G-code, Ruida, SVG, DXF, PDF), Save as Template, Project Notes, the material and art libraries, the material test, cut order optimization, the camera, history, My Job Is…, the user guide and Share Feedback. Preferences are at the bottom of the Layers tab (Preferences…). When space runs short in portrait, the arrange bar scrolls with a finger.
- On iPhone (companion): Bernie starts and follows your jobs; the drawing is prepared on iPad or Mac. Open a project (iCloud Drive, Files…): the Project tab shows the preview of what will be engraved, the estimated time, the footprint and the chosen device; the Laser tab is the full Laser panel — network laser (Wi-Fi, Ethernet), laser shared by a Mac or by Bernie Link, virtual laser, framing, Start with the same checks and confirmations, Pause, STOP; the Help tab opens this guide.
Drawing
| Tool | Use |
|---|---|
| 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. |
| Tabs | Click 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).
| Tool | Use |
|---|---|
| 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
- Shapes › Union, Subtract, Intersect: combine the selected closed shapes (for Subtract, the last selected shape is removed from the others). The result keeps true curves and its corners.
- Shapes › Offset Path…: grows or shrinks (round, sharp or bevelled corners). Repeat Last Offset (or ⌘-click the toolbar button) applies the same settings without opening the dialog.
- Shapes › Auto-Join: joins lines whose ends touch; Close Paths…: closes paths whose ends are close; Rebuild Curves: turns runs of small segments (DXF, tracing) into curves; Delete Duplicates.
- Shapes › Cut With Shape: the closed shape selected last cuts the others (shapes and lines) into an inside part and an outside part; it disappears. An image becomes two masked copies: one limited to the inside of the shape, the other to the outside. Mirror Across Line: mirrors the objects across the line selected last. Shear…: slants the selection (horizontally or vertically). Warp (4 Corners): drag the magenta corners of the selection and the shapes follow; each corner drag is undone separately; Enter, Esc or a click elsewhere finishes. Warp (16 Points): a 4 × 4 grid of handles for free-form warping (making a text follow a shape); Shift repeats the drag mirrored on the left-right symmetric handle, Option on the top-bottom one, a double-click resets a handle.
- Shapes › Boolean Assistant… (two closed shapes selected): shows union, A minus B, B minus A, intersection and exclusion side by side; one click applies the chosen result.
- Shapes › Rubber-Band Outline: adds a shape that wraps the selection, like a rubber band stretched around it.
- Shapes › Optimize Shapes…: fewer nodes for paths made of small segments (DXF drawings, traced images) — smooth curves, lines only, or arcs and lines (shorter G-code, smoother moves), within the chosen tolerance; the dialog shows the node count before and after.
- Tools › Art Library…: your reusable drawings, sorted into libraries (New…). Add Selection… stores the selection (shapes, groups, their layers' settings, images); one click on a thumbnail inserts it at the center of the view; right-click: rename, replace with the selection (the edited drawing keeps its name), move to another library, delete. The … menu: Import Bernie Files…, Show Folder (Application Support/Bernie/art, to back them up or share them), Rename Library…, Delete Library… (its drawings go to the Trash). In Bernie Studio: File › Art library… (Rename…, Delete…, Replace and Move to… under each thumbnail; the library's Rename… and Delete… next to its list; library kept in the browser). Download… lists the libraries published on the Bernie website — basic shapes, frames and labels, geometric patterns, marks and templates: original drawings, free to use — with their number of drawings; Install turns one into a library like the others, Update appears when a new version is published (drawings with the same name are replaced, those you added stay).
- Edit › Mouse Gestures: move, rotate, resize — uncheck a gesture so the handles can no longer do it by accident (the inspector and arrow keys still work). In Bernie Studio: at the bottom of the edit bar's Select menu.
- Shapes › Resize Slots…: straight notches and mortises of a given width (within the tolerance) get a new width — to fit a joint to the actual material thickness; tabs do not move. The dialog counts the slots found before applying.
- Shapes › Rotate by Two Points: click the pivot, a reference point, then that point's new position (live preview, snapped to nodes); Rotate and Scale by Two Points also adjusts the size. Esc cancels.
- Fillets (Nodes tool, inspector): a negative radius cuts an inverted fillet; with the two nodes of a rounded corner selected, “Round” redoes it with the new radius and “Remove” brings the corner back.
- Polygon: number of sides and star (inner radius as a percentage) in the inspector; dual star: a second family of points, interleaved with the first, whose tips have their own radius.
- Tools › Tangent Circles…: with three circles selected, shows every circle tangent to all three (up to eight); tick those to create (active layer). The new circles can be used as a base in turn.
- Edit › Invert Selection (⇧⌘I), Select Contained Shapes (inside the selected closed shapes), Select Smaller Shapes (than the largest selected object), Select Circles… (by diameter: holes in an imported drawing).
- Calculations in fields: every number field accepts a calculation (
100/3,(80-4)*2), a unit (2in,1/4",3 cm,72pt) or a percentage of the current value (50%). - Shape power (inspector, Cutting section): a share of the layer's power for the selected objects (100%: the layer's) — a lighter detail without creating a layer.
- Group (⌘G) and ungroup, lock (locked objects no longer move and cannot be deleted).
- Arrange: align, distribute, place on the bed, grid and circular arrays. Align › Alignment Assistant… shows each alignment on the workspace on hover; a click chooses it, OK keeps it, Cancel puts the selection back. Virtual Array (checkbox of the Array window, grid): clones linked to the original, dashed, that follow each of its changes (position, rotation, shape); they are engraved and exported but cannot be selected. Right-click the original, or Arrange › Virtual Array: Flatten (independent copies) or Remove Clones. - Move Together (horizontally, vertically): shapes touch, with no gap, in their order. Same Size: width or height of the last selected object. - Dock (left, right, up, down): each shape slides until the neighbouring shape or the edge of the bed, with a chosen padding; options: whole selection as one block, keep inner objects together (a hole follows its part). - Move Under Laser Head: centres the selection under the last known head position. - Stacking Order: bring to front (⇧⌘]), bring forward (⌘]), send backward (⌘[), send to back (⇧⌘[) — it is also the cutting order when optimization is off. - Grid Array: besides count and spacing, shift of every other column or row (staggered), copies to the left or upward, mirror every other column or row, random orientation (each copy turns by an angle drawn from a seed: the same seed gives the same layout again). - Copy Along Path…: select the objects, then the path last; copies spread by count or by spacing, rotated along the path, with progressive size; variable text: step per copy numbers the copies (serial numbers, CSV rows). The copies stay selected. - Quick Nest…: packs the selection into the bed (or the last selected shape) by the real outline of the shapes, largest first, with spacing, allowed rotations (none, half turn, quarter turns, or every 45°, 30° or 15°), around objects already there; what doesn't fit goes on extra beds to the right, or stays in place (a message says so). A group stays in one piece; a small part can fit in the hole of a large one. Fine nesting: finer grid and several placing orders tried (by area, height, width, longest side), keeping the best — denser, slower. - Auto-Group: each closed shape is grouped with what it contains (holes, engravings).
- Cut, copy, paste, duplicate (⌘D duplicates in place); Paste in Place (⌥⌘V) pastes where the copied objects were, without offset.
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.
- Save as Preset…: name the settings of the selected image and choose which ones to include (All, None, Invert). Speed, power and passes are left out by default, since they depend on the machine and the material. A setting left out stays unchanged when the preset is applied.
- A preset's layer settings apply to every image on that layer.
- Manage Presets…: delete yours, import or export them (File menu) to move them to another computer. They are also included when you export your preferences.
Layers
Each layer is a laser process, identified by its color.
- A new document has a red layer. “+” to the right of “Layers” adds one: its color is chosen for you. A long press on “+” offers the tool layers T1 and T2 (guides and templates, never engraved), and Sort: Cuts Last (layers in Line mode go after the others: a cut-out part could move before being engraved). The “…” menu (or a right-click on the “Layers” header) acts on all layers at once: sent to the laser (all, none, invert), visible (likewise), air assist (everywhere, nowhere, invert), cuts-last sorting — each command undoes with ⌘Z.
- Engraving order: the laser engraves layers from top to bottom. Drag a layer up or down, as in any Mac list: an insertion line shows where it will go (or right-click › Move Up / Move Down).
- Click the color of a layer to choose another; each color shows its layer number (00 to 29), as does the color square on each row. A color marked with a dot belongs to another layer; choosing it swaps the two colors.
- Click a layer: it becomes the active layer (shapes drawn next go on it) and its settings are shown. The selection does not change layer: to move it there, use the button that appears on the layer's row, or right-click the canvas.
- Lightning bolt: layer sent to the laser or not; eye: shown or hidden.
- Right-click a layer: select its objects, flash them to spot them, move it up or down the output order, copy and paste its settings, add a sub-layer, set the defaults for new layers, delete its objects or the layer.
- Color strip below the canvas: one numbered swatch per color (00 to 29, T1, T2). Solid: the layer has shapes; faded: it has none; outlined: the active layer. Click: selects the layer's shapes and makes it active (Shift-click adds them to the selection); hovering shows its name and number of shapes. Right-click: move the selection to this layer, or to a new layer.
- Split shapes of a layer (for example after an SVG import): select them, then right-click › Layer › New Layer — they move to a layer of their own, which keeps the old layer's settings.
- A shape on a fill layer is shown filled (View › Filled Display, on by default; in Bernie Studio, a checkbox in the status bar).
Cut Settings
- Line: follows the outlines (cutting, line marking). Options: kerf compensation, tabs, perforation. - Tabs: length, count per shape or spacing (with a maximum count), no tabs on holes (they fall out as scrap), power in tabs (0: laser off; a low power scores the tab so it breaks more easily; as pulses if the device asks for it, see Devices). Tabs placed by hand with the Tabs tool are cleared for the whole layer with "Clear the hand-placed tab(s)". - Lead-in, lead-out and pierce (collapsible section): overcut (the cut of a closed shape goes back over its start), lead-in and lead-out as a line or an arc, placed on the scrap side — outside parts, inside holes — so the start of the cut doesn't mark the part, and pierce: a pause with the laser on at the start of each cut (time, power), to get through thick material before moving. The preview marks each pierce with a small cross.
- Fill: scans the inside of closed shapes (even-odd rule: a shape inside another makes a hole). Options: interval, angle, cross-hatch, bidirectional, separate islands, fast travel across gaps, flood fill (each connected region is filled step by step — the two arms of a “U” one after the other — instead of crossing gaps on every line: less travel; best kept for machines without backlash), edge ramp (power rises from minimum to maximum over this distance from the edge: softened edges, relief effect; on every edge or outer edges only), rotation per pass (with several passes, the angle turns at each pass).
- Offset (Offset Fill): fills closed shapes with successive outlines offset inward at the chosen spacing, from the outside to the centre. Faster than scanning on thin shapes (text, frames), with no overscan.
- Image: engraves a dithered image. As with fills, Fast Whitespace Crossing crosses white areas of a few millimetres or more at rapid speed.
- Speed and power (maximum; minimum for slowdowns — on a Ruida controller this is the power in corners, “Corner Power”; everywhere, the low end of grayscale and ramps), passes, air assist. With a scribe, power does not apply and is not shown. Ruida machine with a dual tube (box in the Ruida window): Tubes — both, tube 1 or tube 2 alone (the other stays off) — and Own powers for tube 2 (min and max); otherwise tube 2 takes the layer's powers. Tubes carry the names given in the Ruida window; with “Only one tube at a time”, the “both” choice goes away. Each sub-layer has its own choice: engraving on tube 1, outline on tube 2, for instance.
- Overscan: the head runs past the end of the lines to engrave at constant speed. Automatic overscan: the distance is computed from your machine's acceleration (Settings › Devices › Motion). It is on for new layers; too short an overscan gives darker edges (the pre-send check reports it).
- Constant power (M3): GRBL only; by default, power follows the actual speed (M4).
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
- Material library: saves a layer's settings by material and thickness and reapplies them in one click; imports LightBurn libraries (
.clb). Manage › Add a Starter Library: general settings — diode 5, 10 or 20 W, CO2 40 to 60 W: cuts and engravings for common materials (plywood, MDF, cardboard, leather, slate, anodized aluminium, acrylic with CO2…), cautious settings; by machine — Creality Falcon2 22 W, Elegoo Phecda, Snapmaker Ray (20 and 40 W modules), xTool D1 10 W, D1 Pro and 20 W, 80 W MOPA and Gweike G2 Max 50 W fibers (frequency and pulse width included); settings collections — settings gathered by diode laser users, the power not always being stated. The material names, titles and descriptions of these libraries are translated into the interface language; the menu shows how many settings each holds (over 700 for the xTool D1). Choosing the Creality Falcon2 22 W, the Snapmaker Ray or an xTool D1 Pro under Commercial machine adds its library and links it to the profile. All of them should be checked with a material test on your machine. In Bernie Studio, the starter libraries are in the window's list, by section, and a Search for a material… field filters long lists; the device window names the chosen machine's library. Never cut PVC or vinyl: they release chlorine, which is toxic and corrodes the machine. Duplicate copies an entry (a variant for another thickness or finish); Manage › Link to Device opens this library by itself when the device becomes active. Manage › Store in a Shared Folder…: iCloud Drive, network drive or synced folder; other computers that pick the same folder see the same libraries (read again each time the window opens, or with Reload Shared Folder). An empty folder receives a copy of your libraries; Back to This Device's Folder restores local storage. - Material test (Laser menu): grid of cells where power, speed, interval or passes vary, with labels (perforated text for a powerful laser: digits as a dashed outline, which do not burn), engraved in order of increasing energy. Keep a Cell: pick the successful cell and the material; its settings go into the library (with the test date) and can then be applied to a layer. Scanning offset pattern preset: five 50 × 10 mm strips, filled back and forth (0.5 mm interval), from a fifth of the device's maximum speed to the full speed (see Scanning offset, below). Focus: Z Height preset (device with a Z axis): one line per head height, from 3 mm below focus to 3 mm above; the thinnest line gives the right Z offset. Firing Threshold: Low Powers preset: twenty lines from 1 to 20 %; the first visible line gives the power below which the laser does not mark (useful for the layers' minimum power and the low end of image gradients). Save as Preset… keeps your own test settings.
- Calibration patterns (Laser › Calibration Patterns), added at the centre of the view with the active layer's settings: - Kerf test: a plate with 11 slots and a tab of the chosen width (the thickness of the material to fit). Each slot is narrowed by a kerf from 0 to 0.30 mm, engraved below it. After cutting, the slot where the tab is a snug fit gives the value to enter in the layer's “Kerf width”. - Backlash test: circles and squares of 5, 10 and 20 mm. An oval circle, or an outline whose start and end do not meet, reveals belt backlash or too high a speed. - Dot width correction test: five 50 % grey squares, each on its own Image layer (ordered dithering, one-way scanning, speed, power and interval of the active layer), with a correction from 0 to 80 % of the interval, written below. The right square forms an even checkerboard: its value goes into the Image layer's “Dot width correction”.
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:
- Side facing the laser: top (most CAD software), bottom, front, back, left or right — a model exported "Y up" (3D software, OBJ) often comes out right with Front;
- Tilt forward, Tilt sideways and Rotation (degrees) to adjust it;
- Width (the height follows the proportions; by default the model's size, reduced to fit the bed);
- Relief kept: thickness kept below the highest point (0 = full height); smaller, only the top of the model keeps its shades and the rest turns black;
- Resolution (pixels per mm, 10 by default);
- Background: fully engraved (the model stands out, raised relief) or left untouched (the model is carved into the material).
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).
- Play (Space) and time slider, speed ×1 to ×200;
- Material (those of the preview: surface and mark color, material more or less easy to carve), Laser (laser power at 100 %, in watts) and Thickness: beyond it, the workpiece is cut through and the cut opens;
- Relief ×1, ×5, ×20: depth exaggerated on screen, to see an engraving a few tenths of a millimeter deep;
- View: drag to rotate, Option, Shift, the right button or two fingers to pan, wheel or pinch to zoom; the house goes back to the initial view; Refresh (Mac, iPad) recalculates after a change to the project.
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.
- The laser card, at the top: the machine (the chosen device), the link (“Bernie Link “Workshop””, USB port, virtual laser…), a colored state badge (Ready, Engraving, Paused, Alarm, Not connected), the head position, the laser's maximum speed and the estimated job time. Clicking the state in the status bar opens this panel.
- The main action, large: Start (laser connected here) or Send Job (shared laser). During the job: the progress, then Pause (or Resume) and Stop (⌘.), as two separate buttons. Stop pauses first, then resets the controller once the head has stopped: no alarm, no lost position. Afterwards, ““name” is finished” (or a banner if the job was interrupted).
- Alarm: a red banner “The laser is in alarm” offers Home and Unlock; no job starts until the laser is ready.
- Start question: the time and the warnings of the pre-send check; when a warning concerns shapes (open shape in a fill layer, duplicate shape…), Show Shapes cancels and selects them on the drawing.
- The tools: Framing (a very weak light dot follows the job outline, at the focus power — 1 % by default — to see it on the workpiece without marking it), Focus (see below), Material Test (the speed × power grid to calibrate a material, also through Bernie Link or a Mac: Send…), Home, Move (arrows at the chosen step, center of the bed) and Max Speed (the speed and acceleration read on the controller, compared with the device's, to copy in one click).
- Laser settings that differ from the device (work area, speed, limit switches): a banner offers Adapt the device, so that Bernie's work area is exactly the size of the laser, job times are right and every job starts from home.
- Automatic homing: on a machine with limit switches, until it has been homed since it was switched on, its zero is wherever the head was (often in the middle); Bernie therefore homes it first before taking the head anywhere (Focus, Framing, Move to the center…). Jobs start from home with the device option “Home the Machine ($H) Before Each Job”.
- Below, collapsible: Job Placement and Options, Connection, and Advanced (state details, manual commands, fire, macros, controller console).
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:
- Virtual (default): a simulated laser that accelerates, brakes and engraves like a real machine, in the Laser › Virtual Laser window. Ideal for trying things safely; simulation speed: real time, × 2, × 5, × 10 or × 50. During a job, the panel's “Laser on” indicator stays visible between scan lines.
- USB: choose the port (or “Find My Laser”, which tries 115,200, 230,400, 250,000 and 460,800 baud) then Connect.
- Network: IP address and port of a Wi-Fi or Ethernet laser (without a port: 23, then 8080 if the laser refuses 23); Search the Network lists the lasers that announce themselves (Bonjour, Telnet service: grblHAL, FluidNC, serial-to-Wi-Fi bridges) and the GRBL boards that don't (ports 23 and 8080: MKS DLC32, many ESP32 boards) — a click fills in the address. The network timeout (Settings › Devices, 5 s by default) limits the wait for the connection and the silence allowed before the laser is considered lost; lengthen it on a slow Wi-Fi. MKS DLC32: its address is shown on its screen (192.168.4.1 when it creates its own Wi-Fi network, "MKS_DLC"); it accepts only one connection at a time: close any other software connected to it. On iPhone, iPad and Mac, Bernie needs access to the local network (Settings, or System Settings on Mac › Privacy & Security › Local Network): otherwise the search finds nothing and the connection reports the address as unreachable.
- Shared: a laser connected to Bernie Link (a small computer next to the laser, without a screen) or to a Mac in Hub mode. The shared lasers on the network are listed; choose it, type its pairing code (where to find it), then Connect. The connection is restored at the next launch.
- Server: a laser driven by OctoPrint (API key: OctoPrint Settings › API, or an application key) or by a Duet board in standalone mode (password set by
M551, empty if none). Address, key or password (kept in the keychain on Mac and iPad), then Connect. The job goes as a file, which the server starts after the safety question; Frame (laser off), Pause, Resume, Stop, progress. The server does not tell where the head is: start from absolute coordinates or from the user origin. In Bernie Studio opened in a browser, the page must be in http (served by Bernie Link, or on this computer) and the server must allow it: “Allow Cross Origin Resource Sharing (CORS)” box in OctoPrint,M586 C"*"on Duet; the desktop app has none of these limits.
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):
- Engrave: a small “F” at the centre of the bed, at low power (height, speed and power adjustable; Frame shows the location first).
- Look at it from the front of the machine and pick the matching thumbnail: upright, mirrored left-right, mirrored top-bottom, or upside down.
- 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.
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.
- Motion: maximum speeds and accelerations (“Read from the connected laser” button) — used for the estimated time and automatic overscan.
- Scanning offset: if, in fast bidirectional engraving, every other line is shifted: 1. engrave the pattern (Laser › Material Test…, “Scanning offset pattern” preset), the first time with compensation off; 2. on each strip, measure the gap between the edges of the forward and return lines; 3. Add a Pattern Measurement: strip speed and measured gap; Bernie keeps half of it. If compensation is already on, the measured gap is what remains: half of it is added to the current offset (negative gap if the edges have reversed).
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.
- Positioning aids: low-power manual fire (to be allowed here), red pointer offset.
- Motorized Z axis: layers then offer a Z offset (head height for this layer, relative to focus) and, from two passes, a Z step per pass to follow the cut into thick material. The head returns to Z 0 at the end of the job. Relative Z moves: for a machine without a Z home, the starting height is the focus and Z moves are relative (G91). Autofocus: the machine's autofocus command (e.g.
$HZ, one command per line); the Laser panel then shows a Autofocus button. A command that would turn the laser on (M3, M4, non-zero S) is refused. Material height (Laser panel, absolute Z moves): the workpiece thickness, added to each layer's Z height so the focus follows its surface; saved with the project. A height unchanged from one pass to the next produces no Z move. - Custom G-code: for a controller with unusual G-code, each command comes from an editable template — job header (metric units block
G21or, when Coordinates in inches is checked, imperial unitsG20— positions in inches, speeds in inches per minute —, then the work coordinate systemG54toG59), job start and end, layer start, laser on and off (once per layer, or around each cut for an on/off controller), rapid move, cut move, dwell, air, Z axis, progress (M73), start and end delays. Variables:{x}{y}{z},{s}/{speed}(mm/min),{p}/{power}(S value),{dwell},{layer},{percent},{remaining};[X]{x}writes the letter only when the value changes,{*power}writes the line only when the value changes;|REL|/|ABS|…|RESTORE|switch to relative or absolute coordinates;{rotary_diameter}gives the rotary diameter (mm);{freq}(kHz) or{freq_hz}and{qpulse}(ns) give the layer's frequency and pulse width, for a MOPA source — as soon as a template uses them, the layer settings offer Frequency and Pulse Width. Escapes:\n(new line),\t,\xHH(character with code HH, for control characters). Prohibited characters: removed from every line written (layer names included). Error and alarm messages: onenumber = messageline per code; they replace GRBL's in the console and alerts. The preview shows the G-code of a 20 mm square; the machine link stays that of the chosen controller. Controller templates: Duet / RepRapFirmware (laser modeM452set inconfig.g,Spower from 0 to 255 on each cut,G0with the laser off, line-by-line link like Marlin), Mach3 / Mach4 and UCCNC (laser driven like a spindle:M3before each run of cuts,M5before each rapid move,Sfrom 0 to 1000,M30at the end) set the templates, maximum power and link in one go — check them on the machine. FluidNC and grblHAL speak GRBL: choose GRBL. - Tab pulse width: low-power tabs are then cut as full-power pulses of this length, spaced to give the same average power — useful on controllers that change power poorly mid-line; 0: reduced power.
- Swap X and Y: for a machine mounted a quarter turn around. Laser-off moves as G0: faster overscan and scan gaps on some controllers (their speed is no longer controlled).
- Tool: Laser, or Scribe (diamond) — the scribe goes down in Z (Working Z, e.g. −0.3 mm, at the plunge speed) to mark and lifts (Clearance Z) for travel moves: no laser and no power, every line of the job is marked, even from a layer at 0 %; no overscan or ramp; an image is engraved with a threshold, dot by dot (very slow: prefer a fill, the pre-flight check says so). With custom G-code, “Laser on” and “Laser off” lower and lift the scribe around each run of lines. The virtual laser marks the lines drawn with the scribe down. Pen (plotter): for a GRBL pen plotter, the pen goes down to draw and up for travel moves, like the scribe. Pen lift: Servo (pen moved by a servo on the spindle output: Pen down command,
M3 S1000by default, Pen up command,M5, then Servo wait, 0.2 s, while it moves; GRBL laser mode off,$32=0) or Z axis (heights and plunge speed, like the scribe). Lines recommended; a fill draws hatching. Knife (cutter): blade offset and overcut — see Cutters and Plotters. - G-code clustering (GRBL, Smoothieware): in image engraving, several neighbouring dots of a line go out in a single
G1(S a:b:c…, the path split into equal parts, Values per line: 2 to 16) — fewer lines to send, smoother high-resolution engraving; a run of a single power stays an ordinaryG1. Only if the controller announces it ([CLUSTER:n]in its$Ireply: grblHAL with the “LightBurn clusters” plugin, some Ortur): otherwise starting a job is refused, as the controller would answererror:1. The virtual laser accepts it. - Negative coordinates: CNC-type machine (converted 3018 router…) whose origin, after homing, is a corner and whose work area extends into negative values; positions are sent as X−, Y−.
- Machine coordinates (G53) (GRBL): jobs in absolute coordinates, framing and moves to a point ignore the G54 work offset; the head position is read in machine coordinates. No effect from the current position (G92) or with the rotary.
- The device list is sorted by name.
- Manufacturer (laser manufacturer bundle): name and links (website, training, support, community) of the device's manufacturer. A manufacturer fills them in, then exports a settings bundle (devices, libraries); for their customers, imported devices show their menu in Help (Bernie Studio: links in the manual window). Only web addresses (https) become links.
- 4th Axis U: for a controller with a U axis (table, rotary…); each layer then has a U Position (layer settings), sent at the start of the layer (
G0 U…) only when it changes. Without this checkbox, it is ignored. - Device at launch (Mac):
open -a Bernie --args -appareil "Device name"opens Bernie with that device active — handy for one shortcut per machine in a workshop with several lasers. An unknown name is reported in the status bar and the active device is kept.
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.
- Galvo laser: source (fiber, MOPA, UV, CO2), field offset and head rotation, mirror driving the X axis, direction and scale of each mirror.
- Jumps and delays: jump speed and wait after a jump (longer for a long jump), laser on, laser off, end and corner delays (µs) — too short or too long, they leave burnt or missing marks at line ends and corners; framing and maximum speeds.
- Lens corrections: bulge, skew and trapezoid of each mirror, from -1 to 1.
- Laser source: depending on the type (fiber, MOPA, UV, CO2, SPI) — allowed frequency range (PWM modulation can be turned off for a CO2), adjustable pulse width and master oscillator of a MOPA, tickle pre-ionization and first pulse killer of a CO2, pulse bounds of a UV, simmer current of an SPI, second source (selection port, analog output; each layer can then choose Laser source 2). Values to copy from EZCad or the manufacturer's data. The virtual galvo flags layers whose frequency or (UV) pulse width falls outside these ranges.
- Rotary (Laser panel, Settings…): to mark all around a cylindrical object on a rotary, the design is cut into slices; the rotary brings each slice under the lens, the galvo marks it, then moves on to the next. Settings: rollers or chuck, motor steps per rotation, roller and object diameters (linked circumference), axis along which the object unrolls (X or Y), slice width (small: fewer defects on a tapered object; large: faster) and overlap (extra length hiding the seams, useful to remove paint, best avoided for direct marking), mark whole shapes if possible (up to a maximum size: the shape is marked in one go, the rotary centered on it), order (all shapes in each slice, never going back, for rollers; or the job order, for a chuck), output center (line of the field under which slices are marked; 0: the middle), motor speeds, direction and return to start. The center line of the workspace is the rotary's starting position: the farther the design is from it, the more the object turns before marking. The virtual galvo gives the number of slices, the rotation and its time (included in the duration), shows each slice as it is marked (‹ Slice n / N ›) and flags a slice narrower than one motor step, fill lines that would cross the slices (set them parallel to the object's axis: 0° if the object unrolls along Y, 90° otherwise) and a layer that fills all its shapes at once while they must stay whole.
- External axis (Laser panel, Settings… of “Split marking”): linear table (X or Y orientation) or rotating table driven by the board — pulses per turn, travel (mm) or axis turns per motor turn, speeds, direction, return to start. Split marking (linear table): a design larger than the field is marked slice by slice, the table bringing each one under the lens (same slice settings as the rotary). Repeat marking: the same job several times, the table moving forward between two markings (mm, or degrees for a rotating table; Calculate gives 360° / count for evenly spaced positions), with a pause to let it settle — batch production, often with variable text. The external axis waits until the rotary is off. The virtual galvo gives the slices or markings, the table moves and their time. Import an EZCad Configuration (markcfg, Motors.ini)… (galvo device settings; Bernie Studio: “EZCad Configuration” section) reads a file from EZCad's
PARAMfolder. EZCad2 (markcfg0tomarkcfg7, the one of the board in use): field size (work area), field offset and rotation, mirror driving X, reversed directions, scales, lens corrections (bulge, parallelogram turned into skew, trapezoid: 1 in EZCad, 0 in Bernie — check them with a calibration grid, as EZCad does not publish its formulas), frequency range of the source; extended axes and the red pointer offset are reported, to set up by hand. EZCad3 (Motors.ini): the linear table it names becomes the external axis (pulses and travel per turn, direction, speeds, acceleration), the A axis sets the rotary. - Live framing (Laser panel): the red frame follows the selection while you place the part. Next style goes from bounds to hull then to contour. With the keyboard (Mac, Bernie Studio) or the buttons: arrows 5 mm (Shift 20 mm, Option 0.5 mm), “.” and “,” rotate by 15° (Shift 1.5°, Ctrl 45°), PgUp and PgDn enlarge or shrink by 5 %. Frame before marking (device setting, on by default): the first “Mark” opens live framing, the second starts the marking. While marking: Pause / Resume and Stop.
- Mark (Laser panel, simulation): the virtual galvo “marks” the job for the computed time (10 s at most, accelerated beyond) then counts the piece. Pieces and Reset; Repeat (the job this many times in a row — to repeat only some layers: passes or global passes); Run continuously (restarts at the end of each piece, for deep engraving; turning it off stops at the end of the current piece); Stop at count (no more starts once this number of pieces is reached); Stop interrupts the current piece, which is not counted. Layer setting Auto-rotate from one piece to the next (fill): each new piece starts turned by one more angle increment, so successive markings do not overlap line by line; resetting the counter restores the starting angle.
- Calibrate Lens (Laser panel button): a one-window assistant. Test pattern: nine crosses and a letter F, centered in the field (suggested size: 85 to 90 % of the field), added to the active layer — mark it on a contrasting material. Orientation: pick, among eight, the letter F as it came out (the pattern in front of you as on screen); a mirrored or rotated output fixes the X-axis mirror and the mirror directions. Measurements: from cross center to cross center, the three rows, the three columns and the two diagonals. Result: scale, bulge, skew and trapezoid of each mirror, computed and saved in the device by Apply; Maximize working area extends the field up to the travel of the mirrors if the lens covers more (power may drop at the edge). A second pattern refines the corrections. Mark the pattern with the galvo board driven directly (experimental) or with the machine's software.
- Cylinder correction: to mark a cylindrical object lying flat, without a rotary (glass, tumbler, pen). The design wraps around the surface — a length of the design across the object becomes an arc of the same length — and each point is aimed where the beam meets the surface. Settings: object diameter, mirror distance (from the mirrors to the focus plane: the lens focal length plus the height of the mirrors above it, not the focus distance), cylinder axis (parallel to X or Y), concave surface (inside of a ring, a cup). Center the design on the object and focus on its top (the bottom, if it is concave); beyond a quarter turn on either side, the surface can no longer be reached: the virtual galvo counts these points, brought back to the edge. The Cylinder correction switch of the Laser panel turns it on or off without opening the settings.
- Layers (galvo device): pulse frequency (kHz), pulse width (ns, MOPA sources) and beam wobble — the spot moves in circles of the chosen diameter along the path, one per set advance: wider line, cleaning, welding (no corner delay). Dot width (fill): each line is shortened by half of it at each end, for clean edges despite the spot size. Layer-specific timings: the layer's own jumps and delays instead of the device's (starting from the device's values); pause before and pause after (ms), for example to let the part cool down between two layers.
- Galvo Board, experimental: EZCad2 JCZ “LMC” boards, connected over USB (Mac, Bernie Studio in Chrome or Edge, desktop app) or to Bernie Link (
--galvo: also for iPad and iPhone, Use Bernie Link Board). Close EZCad, plug in the board, Connect to the Board… (in the browser, pick it in the window that opens). Frame (Red Pointer) traces the framing chosen for the virtual galvo in a loop, laser disabled; Mark… (after framing if the device requires it) asks a safety question, then marks the job as the virtual galvo computes it; Stop stops at once (laser disabled, pointer off), including a confirmed marking that has not started yet. Rotary, external axis and repeated marking are not driven yet: turn them off. On Windows, the board must use the WinUSB driver (Zadig tool) instead of the EZCad one (reinstall the EZCad driver to go back); on Linux, the.debpackage installs the access rule (60-bernie-galvo.rules, plug the board in again); with the AppImage, copy it to/etc/udev/rules.d. Bernie has not yet been tried on a real board: stay near the machine, with suitable glasses and the enclosure closed. - Laser panel: the JCZ Board (EZCad2) line gives the number of 256-command packets the driver would send and checks that a virtual board, reading them back, goes through exactly the marking positions; the virtual galvo computes the job's marking — duration, length actually marked (wobble included), marks, jumps — flags points outside the field and draws it: marks in black, jumps dotted, framing in red (none, bounds, convex hull or exact contour: the path the red pointer would follow to place the part). Options: frame each shape (bounds, hull), outside shapes only (contour, without letter insides or holes), tool layers only (frame the templates on layers T1 and T2, never marked, instead of the job). In contour mode, a filled area or an image is framed by its hull, not line by line.
- Bernie Studio and desktop app: the Galvo laser box of the Device window (device name in the status bar), same settings and same layer settings; the Laser tab shows the virtual galvo.
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.
- K40 board (device settings): board model (M2 by default), serial number if the board asks for it (a locked board refuses jobs without it), maximum speeds, return at the end of the job. Origin at the top left, at the end stops.
- Connect (Laser panel, K40 Laser block): on the Mac, in the desktop app (Windows, Linux) and in Bernie Studio opened in Chrome or Edge; on iPad and iPhone, through Bernie Link (
--k40option). Close K40 Whisperer or LaserDRW first. On Windows, the board's USB chip (CH341) must use the WinUSB driver, installed with the Zadig tool instead of the manufacturer's; on Linux, Bernie's packages install the USB access rule. - Frame: homes, then the head traces around the job with the laser off.
- Engrave…: after the safety question, the head goes to the origin, then engraves. Vector paths are engraved in “twitchless” mode; horizontal fills and images are scanned by the board itself, in one direction or both; an angled or cross-hatched scan is engraved as paths, more slowly.
- Power: on an M2, it is set with the K40's panel knob (with the ammeter); the board only turns the laser on or off, and the layers' power is ignored. A recent M3 receives each layer's power. For images, prefer dithering: grayscale gives no shades.
- Pause, Resume… (after a question) and Stop (emergency stop, at any time).
- Move the head: arrows in steps of 1, 10 or 50 mm, Home, Unlock the head (motors released: the head can be pushed by hand; the next job starts again from the origin).
- Placement: the board does not report where the head is; choose “Absolute coordinates” or the user origin. Every job and every framing starts again from the origin.
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.
- Creating the device: Bernie tour or Add a Laser… › Cutter / plotter. At "Your machine", Controller: HPGL cutter (serial port) for most vinyl cutters, Silhouette (USB: Cameo, Portrait), or GRBL machine (knife or pen) for a plotter or a self-built machine; work area (cutter width × material length) and origin, most often bottom left. The Starter — cutter library (adhesive vinyl, heat transfer vinyl, paper, cardstock…) gives starting speeds, and the example project is a sticker.
- Knife tool (device settings): the blade tip is offset from the holder's axis. Blade offset (about 0.25 mm for a 45° blade, 0.5 mm for 60°): Bernie swivels the blade around each corner, for sharp corners. Overcut (1 mm by default): the start of closed shapes is cut again, so they come off. On a GRBL machine, the knife is lifted like a pen (servo or Z axis). Prefer Line mode: a fill would be cut line by line (the pre-send check warns about it).
- Laser panel of an HPGL cutter (Mac, Windows and Linux desktop app): the cutter's serial port, port speed and flow control (software XON/XOFF, hardware RTS/CTS, or none) — those of the machine, often 9600 baud. Test the link asks the cutter for its model, without moving anything (many do not answer, which does not mean the link is at fault). Send to the cutter: it starts as soon as it receives the job — load the material, check the blade and the origin; Stop sending does not clear its memory, it finishes what it has already received. Virtual cutter (test without a machine): the job goes to an imaginary cutter, which reports what it received. On Linux, the serial port requires the
dialoutgroup (Bernie gives the command). - HPGL file (.plt): Laser panel, or File › Export as HPGL (.plt) (Bernie Studio: File › Export › HPGL) — to send it with other software; it is the output on iPad, iPhone and Bernie Studio in a browser. 40 units per millimetre, in the device's coordinates (origin, swapped X and Y), tool up
PUand downPD. - Speed: that of each layer (mm/s; 100 mm/s gives
VS10, in cm/s). The blade pressure is set on the cutter. - Silhouette (Cameo 1 to 5, Cameo 4 Plus and Pro, Pro MK-II, Cameo 5 Alpha, Portrait 1 to 4; Mac, Windows and Linux desktop app): over USB, without Silhouette Studio. Laser panel: Connected Silhouette (recognized with its model), Model, Blade pressure (1 to 33: vinyl 8 to 12, cardstock 25 to 33), layer speed (cm/s, up to 10 or 30 depending on the model); Test the link reads the machine's name and version; Send to the Silhouette — load the mat or the sheet first. The Silhouette corrects the blade itself; Bernie adds the overcut of closed shapes. Starting area: the 12 × 12 inch mat, origin top left. On Windows, the Silhouette must use the WinUSB driver (Zadig tool, instead of the printer driver); on Linux, the USB access rule is installed by Bernie's packages. Close Silhouette Studio before sending. Virtual Silhouette to try without a machine. Not yet on iPad, iPhone or in a browser.
Placing and Framing
- Start from: absolute coordinates (the design is engraved where it is on the bed), current head position, or user origin. Except in absolute coordinates, the job origin (3 × 3 grid) says which point of the design goes under the head.
- Selection Only (preview banner, Laser tab of Bernie Studio): only the selected objects are sent; with “origin on the selection”, the job origin is computed from them, otherwise from the whole drawing (the selection keeps its place, to re-engrave part of a job). The state of these two options when a project opens is set in the preferences, which can also save them with the project.
- Frame: the head traces the job outline, laser off (or on at low power if manual fire is allowed); “Job Outline” follows the hull instead of the rectangle; “Loop” repeats until Stop. A job that goes outside the work area is neither framed (the head would hit its end stops) nor sent.
- Controls: home, unlock, arrow jogging (press and hold: up to the edge), go to coordinates or to the selection, 0,0 here (machines without limit switches), job end position. The jog step and speed are kept between sessions. From Machine Zero: the arrows bring the head to the chosen distance from machine zero on their axis (G53) instead of moving it by that distance. Numeric keypad (canvas active, laser connected): 8 2 4 6 and the diagonals 7 9 1 3 move the head by one step.
- From the keyboard: ⌥⌘ ← → ↑ ↓ move the head by one step (Laser menu › Move Head). Right-click › Move Head Here sends it to the clicked point of the bed, laser off (also in Bernie Studio, laser connected).
- Positions: save the current head position under a name (corner of a jig, bed centre…), then go back to it in one click; they are kept in the device profile.
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).
- Create a zone: draw it on the workspace — rectangle, circle or any closed outline, placed to the millimeter with the inspector —, select it, then Add the Selection in the device settings. The drawn shape can then be deleted: the zone stays, hatched in red on the bed.
- Name, Active (a disabled zone stays in the list without being checked) and Moves forbidden too: without this box, only firing is forbidden (the head may fly over the zone with the laser off); with it, the head does not go there at all, framing included — for a tall clamp or a stop it would hit. Zones forbidding moves are cross-hatched.
- Checking: before each job, material test and framing, on the path actually sent (placement at the head or at the user origin included); a job that would fire in a zone, or pass through a zone forbidding moves, is refused with the name of the zone. A G-code file run as is is checked too (if it uses absolute coordinates). The K40 respects them the same way.
- Shared laser: Bernie Link checks the jobs and framings it receives against the zones of the device it keeps (Send Device), and refuses them if they enter one.
- With the rotary on, the height of the design becomes a rotation: the zones are not checked.
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:
- Name: shown in the layers (“Infrared 1064 nm”).
- Offset X / Y (from the second head on): position of its beam relative to the first one, in machine coordinates (mm). To engrave in the same place, the machine moves by the same amount: the design stays in place on the workpiece.
- Commands to Select It: the G-code that switches to this head, one command per line (
M3010,T1,M6 T1,G4 P1to wait…). - Maximum Power (S): S value for 100% on this head; 0 keeps the device's.
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.
- Resuming after a power cut: during a job, Bernie keeps a copy of the project and notes how far the engraving has got. If the job does not end normally (power cut, computer switched off, laser unplugged, alarm), a banner offers to resume it, at once or at the next launch. Resume… reopens the project as it was, with the preview stopped a little before the stop (the controller receives moves slightly ahead): compare with the workpiece without moving it, adjust the slider if needed, connect the laser, then Start Here; Forget removes the offer. Resuming lands right when the job starts from known positions: homing before each job, or the user origin; when starting from the current position, first bring the head back to the job's starting point. Jobs on the virtual laser are not tracked. Bernie Studio and the desktop app do the same (copy kept by the browser), with the time slider and Start Here in the preview card.
- Checklist (Settings › Laser › Before and After Each Job): before the confirmation, a list of items to tick (focus, workpiece secured, air assist and fume extraction, glasses…), editable, one item per line.
- End sound: a sound signals the end of the job (can be turned off in the same place).
- Job log (Laser › Job Log…): every job is recorded with the project, device, estimated and actual times and its outcome (finished, stopped, error); CSV export for a spreadsheet. After three finished jobs of at least one minute, the preview also shows the time based on your jobs on this device. Virtual laser jobs are not recorded. In Bernie Studio: Laser panel › Job log… (log kept in the browser).
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.
- Counting: each job sent to the laser is counted when it ends — its actual duration, and its estimated firing time scaled to that duration (a machine slower than planned fires longer); a stopped job counts the part done. Virtual laser jobs do not count. Galvo and K40 boards connected over USB count their jobs the same way.
- Maintenance reminders: each has an interval in firing or work hours — by default, clean the lens every 20 h of firing, clean the rails and check belts and wheels every 50 h of work; for a CO2, clean the mirrors (20 h of firing) and change the cooling water (100 h of work); for a galvo, the lens every 100 h of firing. Edit Reminders… changes, adds or removes them.
- Maintenance due: when an interval is reached, an orange banner says so at the top of the Laser panel; Done records the maintenance (the date is kept) and the reminder restarts from zero.
- Reset… (new machine, tube replaced): the counters restart from zero, the reminders stay.
- The counter follows the device: a renamed device keeps its own. A laser shared by Bernie Link keeps its own counter, the machine's, whichever device sends the jobs; when connected to it, the panel and the window show its counter, and Done is recorded there. In Bernie Studio, the counter is kept in the browser.
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).
- 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.
- 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).
- 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).
- Open the Projector Window (Mac, Bernie Studio, desktop app): choose the projector's screen if it is offered — the window goes full screen on it —, otherwise move the window to the projector and make it full screen (in Bernie Studio: Full screen button or double-click). On iPad and iPhone, connect the projector (USB-C, HDMI) or choose it in Screen Mirroring (AirPlay): Bernie shows the paths on it instead of mirroring the screen.
- Show: objects sent to the laser (in their layer's color; a dark layer is projected in white), job frame (dashes), no-go zones (red), templates of the tool layers T1 and T2. The image follows the frontmost project, at every change.
- Calibrate the Projector (once per device, or after moving the projector): four numbered markers are projected; bring each one onto the corner of the bed with its number — 1 back left, 2 back right, 3 front right, 4 front left — by dragging it in the preview, then with the arrows (steps of 1, 10 or 50). If a corner is not visible, bring the marker onto an engraved mark and enter its position on the bed (X, Y in mm). Reset Calibration goes back to the starting calibration. The calibration is kept for the device.
- Paths are projected where the job will be engraved in absolute coordinates; the height of the workpiece is not corrected (a thick workpiece shifts the image slightly if the projector is not vertical).
Print & Cut
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.
- 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.
- 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.
- 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:
- Move Head to Center;
- Add Guide Circle to Project (layer T1, never engraved) to see the workpiece in the workspace;
- Center Selection on Workpiece (start in absolute coordinates);
- User Origin at Center: the job starts from the user origin, centered on it.
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.
- All around the object: Add Unrolled Template places on tool layer T1 (never engraved) a rectangle of the engraved width × the object's circumference; a design placed inside goes exactly around a tumbler or a bottle.
- Tapered object (Tools › Tapered Object…): on a flared tumbler or a cone, a wider section moves faster under the laser; the selected design is widened where the object is narrower and narrowed where it is wider. Give where the object's top is on the design, the top and bottom diameters, the object length, the distance from its top to the design and the diameter the rotary is set for (the design keeps its size there).
- The rotary settings are saved with the project; on opening, if they differ from the active device's, Bernie offers to use them.
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
- Bernie projects (
.bernie): design, layers, output settings and embedded images; the project remembers the device it was saved for and offers to switch back to it when opened. - Import: SVG, DXF, PDF, Illustrator (
.ai), EPS (.eps,.ps: paths and colors; convert texts to paths before exporting, images are not imported), LightBurn (.lbrn2,.lbrn), xTool Creative Space (.xcs) and EZCad2 (.ezd, galvo lasers) projects, Ruida machine files (.rd), HPGL plots (.plt,.hpgl: one pen = one layer), G-code (laser-on moves become paths), images (PNG, JPEG, BMP, GIF, WebP, TIFF), 3D models (STL, OBJ, 3MF, PLY, OFF, AMF: depth map, see 3D models), at the size given by the resolution stored in the file (96 DPI if it has none). Texts in SVG and DXF files (TEXT, MTEXT) stay editable texts: font, size, bold, italic, alignment, lines and color are kept. - LightBurn projects: shapes, groups, texts (editable; if the font is missing, imported as paths with their original look), layers and their settings (mode, speed, powers, passes, interval, tabs, sub-layers…) and, in an empty project, layer order, optimization and notes. Positions are measured from the bottom-left corner of the bed, as in LightBurn; a project made for a larger bed says so.
- xTool projects (
.xcs): rectangles, ellipses, paths, texts and images of the first canvas, groups, one layer per xTool layer color; xTool's engraving settings (specific to its machines) are not imported: set the layers' speed and power. - EZCad2 projects (
.ezd, the software shipped with most fiber galvo lasers): curves, rectangles, circles, ellipses, polygons, groups and copy arrays, hatches (turned into fill layers with their interval, angle and cross-hatch; outlines marked if the hatch marks them), images; the letters of a text come through the outlines EZCad saved. Each pen used becomes a layer: speed, power, passes, frequency, pulse width (MOPA), wobble, jumps and delays (laser on, laser off, end of path, corners) — a pen left as "Default" is named "Pen N". The center of the EZCad field is placed at the center of the work area: choose the galvo device with the right field size first. EZCad commands (wait, inputs/outputs, axis) and hidden objects are not imported; EZCad3 projects (.ez3) not yet. File › Export for EZCad (.ezd, Experimental)… (Bernie Studio: File › Export › EZCad) writes the document (or the selection) the other way, to mark with EZCad until Bernie drives galvo boards: each layer becomes a pen (speed, power, passes, frequency, pulse width, wobble, jumps and delays — those of the galvo device when the layer has none), each shape a curve, fill layers hatches (interval, angle, cross-hatch, bidirectional or one way — the angle is converted: EZCad measures it with Y up, so 33° in Bernie reads 327° there, same lines), offset fills their concentric outlines as curves, each active sub-layer one more pen ("Name (2)"…), all in engraving order, Bernie's groups as EZCad groups (within each layer), each image a grayscale image (adjustments, rotation, mask and negative applied, at the layer's line interval) whose dithering is set in EZCad (image parameters); the center of the work area becomes EZCad's origin. Texts go out as outlines. Experimental: files opened in EZCad 2.14.11 (shapes, hatches, image, sub-layers, groups and pen settings checked on 12/10), not yet marked on a machine — check them in EZCad before marking. - Ruida machine files (
.rd, saved by RDWorks or LightBurn for the Ruida controllers of CO2 lasers): cut paths and layers, each on the layer of the closest color with its speed and power. A.rdfile is already "compiled" for the machine: curves, fills and images are segments or scan lines in it, imported as they are, as lines. File › Export for Ruida (.rd)… (Bernie Studio: File › Export › Ruida) writes the job the other way: a file to copy to a USB stick for the machine's screen, each layer with its color, speed and powers, coordinates starting from the job's top left corner (then placed from the machine). Experimental: not yet tried on a real controller — check the drawing on the machine's screen, then engrave at low power first. Variable power (grayscale images, reduced-power tabs), pierce dwells and per-layer Z height are not carried over: Bernie says so after saving. Laser › Send to Ruida Controller (Network)… (iPad: “More” menu › Export; desktop app: File › Export › Ruida over the network…) sends this same file to the controller over the network (IP address shown on the machine's screen, port 50200): the controller starts the job as soon as sending ends, hence the Send and Start button, below the warning. Choose the controller model (most of them, or the 634XG). On the Mac, the sheet also offers the USB link (the controller's port, cable in its “PC” socket, not the USB stick one); the menu there is called Send to Ruida Controller…. A device with a Ruida controller — found by “Find My Laser” (on the network, and over USB on the Mac) or chosen under “Your machine” for a CO2 laser — has its own Laser panel: link kept in the profile, controller model, link test, sending. Virtual machine (try without a laser): the job goes to an imaginary machine inside the app, which tells what it received. RF tube: check it for an RF CO2 tube; otherwise (glass tube), a 0 % minimum power is flagged in the remarks — the controller uses it as the corner power, and a glass tube fires poorly below its threshold. Save to the controller (named file): the job goes with a name (letters, digits, space,-,_,., 24 characters at most) and the controller keeps it in its memory, to start again from its screen; Number automatically moves the final number on after each successful sending (Bernie-001, Bernie-002…). Experimental: depending on the model, the controller may also start it right away — same precautions. Information reads, without moving or firing anything, the card ID and version, the power-on and work times, the number of jobs run and of documents in memory. Dual-tube machine: shows, in the layer settings, the choice of tubes and the own powers of tube 2 (the.rdfile then carries each tube's powers;.rdimport reads them back). The Dual tube section gives each tube a name (“Engrave”, “Cut”… used in the layer settings), Only one tube at a time (each layer fires one or the other, never both) and, for a two-head machine, the second head offset (X and Y, in mm): layers using tube 2 only are shifted by that much to line up with those of tube 1 — measure the gap between the engravings of the two heads, negative if head 2 is farther from the machine origin. A layer using both tubes engraves two copies at once (two heads), without offset. In the same window, Frame takes the head around the job, laser off, and Stop the machine sends the stop order to the controller (a sending in progress is stopped first) — the machine's emergency stop button remains the safest. Start with Test the connection: Bernie asks the controller for its card ID (read only, nothing moves or fires) and tells whether it answers. LightBurn or RDWorks, when open, may hold port 40200 on the computer, where the controller answers: close them before sending. - Templates: File › Save as Template… keeps the project as it is (shapes, layers, settings); New From Template opens an untitled copy (the template is never modified); the last ones opened are listed first (“Recent”). In Bernie Studio, Templates… button: new project from a template or from a file, and saving the current project as a template (templates kept in the browser).
- Project notes (File › Project Notes…): instructions, material, settings tried — saved with the project.
- Export: SVG, DXF, PDF (vector, 1:1 scale, one color per layer), for Illustrator (PDF-compatible
.ai: paths remain editable), G-code, Ruida machine file (.rd, above); Trace Images… traces several image files (default settings) and writes one SVG per image in the chosen folder (Bernie Studio: File › Trace images…, the SVGs are downloaded — in a zip archive when there are several); Export Original Image… saves the file of a project image. - Print… (⌘P): the design (or the selection) at 1:1 scale, in black; Print in Color… keeps the layer colors. Fill layers print filled — handy for a paper template. Printed line width (Settings, 0.15 mm by default, to the thousandth): for a cutter driven by a printer driver, which recognizes a cut by the exact line width. In Bernie Studio: Print… button (in layer colours or black, selection only, line width), then the browser's printing.
- The clipboard is shared with other applications (shapes, images); text copied elsewhere becomes a Text object at the center of the view.
- Drag and drop onto the canvas: files to import, content dragged from another application (SVG, PDF, image, text); a
.bernieproject opens in its window, a.bernielotsettings bundle offers its import. - File › New Project from File…: opens an image, an SVG, a DXF, a PDF, a LightBurn project… in a new project (the original file is not modified).
- When a project opens, Bernie reports fonts missing on the computer: the texts keep their saved outline; Tools › Replace Missing Fonts… makes them editable again.
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.
- Choose: by category or by search, in any language (“reindeer”, “renne”…). Each thumbnail gives the size of the piece, the plywood thickness and the operations (engrave, cut).
- Your laser: diode, 2 to 3 W, 5 W, 10 W, 20 W and more, or CO2, 40 to 60 W. The project opens with an Engrave layer (fill) and a Cut layer (line) set from the plywood starting settings of that laser (for a 2 to 3 W diode, the ones that come with the drawing). These are starting settings: run a material test on a scrap first.
- Your text: place cards, name plates, plant markers and baby ornaments have editable text (“your own text” under the thumbnail). Type it before opening: it replaces the proposed text, centered and at the same size (reduced if it is too long). It is then a text like any other: double-click it to change it, or make a series of place cards with variable text.
- Open: on Mac, in Bernie Studio and the desktop app, the example opens in a new project; on iPad and iPhone, create a new project first: the example is placed in it. The piece is grouped, centered on the bed, and the view is framed on it.
- Included or downloaded: twelve examples (“included”) come with Bernie and open without a connection; the others are downloaded when you open them (a few tens of KB each).
- Fonts: the texts of the examples use three free fonts that come with Bernie, also available for your own texts: Pinyon Script (script), Crimson Text (serif) and Poppins.
- The drawings come from the free library of Lùmen (lumenlaser.app), placed in the public domain by their author.
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.
- 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.
- 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.
- 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.
- Status bar: “+ Page” (single-page project) or ‹ page name › to go from one to the other; the pages menu adds an empty page, duplicates the page shown (copy of its objects), renames it, moves it left or right, deletes it (with all its objects, after confirmation). Also in File › Pages (Mac) and the More menu (iPad, iPhone).
- Undo: changing page, adding, duplicating, renaming, moving or deleting a page are undone like the rest; undoing can therefore take you back to an earlier page.
- Engraving: the job, preview, export and pre-flight check apply to the page shown. The project keeps the page shown when saved: the
berniecommand and Bernie Link engrave that one. - File: a project with several pages is saved in format 2; a version of Bernie without pages refuses to open it rather than lose pages. A single-page project remains readable everywhere.
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), 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.
- Turn on: Settings › Automation › Laser Sharing (Hub Mode) › Share Laser on Local Network (off by default). The Laser panel shows it at the top ("Shared on local network", code and devices).
- Pairing code: eight characters shown on the Mac, to type on the other device; it stays the same from one launch to the next. New Code removes access from devices already paired; after too many wrong codes, the code changes by itself.
- Every start is confirmed on the Mac: a job sent (or resuming a paused job) opens a request on the Mac's screen — device, job name, lines, extent, maximum power. Start or Refuse; nothing starts remotely. A job that goes outside the work area can't start, as with a G-code file opened on the Mac. Pause and stop remain possible from the other device.
- Local network only: the Mac only answers local network addresses (never from the Internet); it announces itself with Bonjour, or can be reached by its address (shown in Settings, port 46490 by default).
- From a browser (Windows or Linux computer, tablet, Chromebook): the Mac itself serves Bernie Studio — open the address shown in Settings › Automation › Laser Sharing ("Bernie Studio: http://…"). In the Laser tab, Laser shared by "Mac": type the code, Connect to Mac, then Send Job to Mac; the Mac confirms it on its screen. The page is not secure (http): WebGPU, the camera and the browser's serial port are not available there; drawing stays smooth with WebGL.
- On the other device (iPad, or another Mac without a laser): Laser panel › Laser Shared on the Network. Macs sharing their laser are listed (a click fills in the address); type the pairing code, then Connect. You see the Mac, the laser, the state and the progress. Send Job prepares the open document's job as it would here (pre-flight check, head position read from the Mac) for the device chosen on this device — choose the same one as on the Mac — and sends it: "waiting for confirmation", then "started" or "refused". Withdraw Request, Pause, Request Resume (confirmed on the Mac) and Stop.
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:
- Bernie Link on Linux, Raspberry Pi, Orange Pi: on the board, with a keyboard or over SSH, run
sudo bernie-hub --code. It is also shown at the end of the installation and in the service log (journalctl -u bernie-hub). - Bernie Link on Windows: in the Bernie Link window (
bernie-hub.exe), which must stay open. - Mac sharing its laser: Settings › Automation › Laser Sharing (Hub Mode).
- Desktop app (Windows, Linux): Laser panel › Connection, once sharing is on.
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 Without a Screen
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.
- Install on a Raspberry Pi (every model, Raspberry Pi OS 64-bit or 32-bit), another ARM board or a Linux PC, in one line:
curl -fsSL https://bernie.websolutis.com/link/install.sh | sudo sh— the package for the machine is downloaded, verified, then installed as a service that starts with the computer; options aftersh -s --(--port,--reseau,--nom); the same line updates it. After that, it updates itself every night, never during a job (to turn it off:sudo systemctl disable --now bernie-link-maj.timer). Windows and installing without Internet: guidedocs/BERNIE-LINK.md. - Start the service:
bernie-hub(first USB port found), orbernie-hub --port /dev/ttyUSB0,--reseau 192.168.1.50for a Wi-Fi/Ethernet laser;--studio <folder>also serves Bernie Studio to the network's browsers;--nom "Workshop"changes the name shown. The pairing code is shown at startup (in the terminal or the service log) and stays the same from one start to the next, power cuts included (to find it again:sudo bernie-hub --code); it only changes after too many wrong codes. The service reconnects to the laser by itself after a disconnection and announces itself on the network (Bonjour: by itself on Linux, nothing to install; through the system on Mac and on Windows 10 and later). The service log follows the system language, or--langue fr|en|es|it|de. - Galvo board (experimental):
bernie-hub --galvoconnects the first JCZ “LMC” board (EZCad2) plugged in over USB instead of a GRBL laser (--source fibre|mopa|co2, fiber by default); at install time:… | sudo sh -s -- --galvo(USB access rule included). Connected devices frame with the red pointer and mark on it (Use Bernie Link Board in the Galvo Board block), each marking after its safety question; rotary and external axis not driven yet. - K40 (experimental):
bernie-hub --k40connects the first K40 with an M2 Nano board plugged in over USB (--k40-carte M3,--k40-serie <number>if needed; otherwise the model and number of the profile sent by a device); at install time:… | sudo sh -s -- --k40(USB access rule included). Connected devices frame and engrave on it (Use the K40 of Bernie Link in the K40 Laser block), each job after its safety question. - No-go zones and counter: Bernie Link refuses a job or framing that would enter a no-go zone of the device it keeps, and keeps the hour counter and maintenance reminders of its laser (shown to connected devices) — see No-Go Zones and Hour Counter and Maintenance.
- Send a job: from the iPad, another Mac or a browser, as with a shared Mac. After sending, the device asks "Start the job on "Bernie Link"? The laser will turn on: stay near the machine.": Start runs the job, Cancel withdraws the request. Nothing starts without this answer, and an unanswered request is withdrawn after two minutes. Only the device that sent the job can confirm it.
- During the job: Pause and Stop from any connected device; Resume… asks the same question before turning the laser back on.
- Remote tools: from the connected device, the Laser panel also offers Framing, Focus, Home, Unlock and Move — laser off, except the focus spot, which Bernie Link caps itself (10 % of the controller's maximum power, 60 s). Bernie Link refuses a job until the laser is ready (alarm, homing, moving) and says why; a job interrupted by the laser (alarm, error) is reported on the device. The maximum speed, acceleration and travel read on the controller are used to set up the device (Adapt the device banner).
- Job queue: laser busy (a job is running, or another device is waiting for its confirmation)? Add a Job to the Queue…: it waits for its turn (8 at most). Nothing starts by itself: at its turn, the start question is asked again on the device that sent it (no answer within 2 minutes: it is removed and the next one goes); a Mac in Hub mode asks on its screen, where the queue is shown too. The laser card shows the queue (Remove for your own jobs) and “…” started by …. A job placed at the current head position cannot be queued.
- Shared laser badge: connected to Bernie Link or a Mac (or in Hub mode), the toolbar shows Bernie Link, Shared Mac or Hub Mode with a green dot (laser ready, job running), orange (laser not connected, in alarm) or grey (pairing code to enter, unreachable); a click opens the Laser panel. A Bernie Studio page served by Bernie Link opens on the Laser tab with the code field in view; the code is remembered and the page reconnects by itself next time.
- Devices and Activity (Laser panel › Connection): connected devices, latest events and, with Bernie Link, New Pairing Code… (the other devices will have to enter the new one).
- Bernie Link device: Bernie Link can keep a device (work area, speeds, power, origin, port speed, firmware) and offer it to every connected device: Laser panel › Connection › Send Device “…”… (after the question; never during a job) — Bernie Link keeps it from one start to the next and reconnects to the laser with it. A connected device that uses another device sees “…” uses the device “…” and Use This Device. A Mac in Hub mode offers its active device the same way. At start-up:
--appareil <catalog machine>(for exampleortur-laser-master-2) or--appareil <.json profile>. - Relay to a Ruida controller: a web page cannot talk to Ruida controllers (UDP network). In Bernie Studio served by Bernie Link, File › Export › Ruida over the network… goes through it: first enter the pairing code in the Laser tab, then the controller's IP address (local network only). Send and start, Frame, Test the connection and Stop the machine work as in the app; sending is confirmed by that button, on the sending device.
bernie-hub --ruida-virtuelsends everything to a virtual Ruida machine, to try without a laser.
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.
- In the Mac app: Settings › Automation › Assistant (MCP) › Local MCP server. The assistant works on the document used last. The server only listens on this computer (127.0.0.1) and every request must carry the token; Show Token gives the command to run in a terminal to add it to Claude Code (
claude mcp add --transport http bernie http://127.0.0.1:46480/mcp --header "Authorization: Bearer …"). New Token invalidates the old one. - Without the app: the
bernie-mcpprogram (in the repository,cargo build -p bernie-mcp) works on.berniefiles: create, open, save a project, import a file, pick one of your devices, export to a file (claude mcp add bernie -- /path/to/bernie-mcp).
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).
- Enable: Settings › Automation › Automation (UDP) › Accept UDP commands from this Mac (off by default). Bernie only listens on this Mac (127.0.0.1), port 19840 by default; replies go to the sender's port 19841, as with LightBurn. New Token invalidates the old one; after too many wrong tokens, it changes by itself.
- Files folder: the app is protected by the macOS sandbox; LOADFILE and IMPORT only open files in the folder chosen here (absolute path inside that folder, or relative to it).
- Message:
token COMMANDortoken COMMAND:argument. Commands:PING(→OK),STATUS(→OK,BUSYduring a job,OK DISCONNECTEDwithout a laser),LOADFILE:file(refused if the open project has unsaved changes),FORCELOAD:file(opens anyway),IMPORT:file(into the open project),LASER:device name,CLOSE(refused with unsaved changes),FORCECLOSE(closes without saving). Errors replyERREUR …with the reason. - **
STARTasks to start**: Bernie runs its usual checks (checklist included) and shows “Start the job?”; the job only runs after your click on the Mac's screen (the Dock icon bounces if Bernie is in the background). TheOKreply means the confirmation is shown; an error if no project is open, the laser is not connected or a job is running. - Command-line tool:
bernie-udp(in the repository,cargo build -p bernie-link --bin bernie-udp), the equivalent of SendUDP:bernie-udp --jeton TOKEN STATUS,bernie-udp --jeton TOKEN "LOADFILE:badge.bernie"(token also from theBERNIE_UDP_JETONvariable); it prints the reply and exits with an error if it is notOK.
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).
bernie verifier project.bernie: check before sending — blocking problems (✗), warnings (⚠); exits with an error if there is a blocking problem.bernie estimer project.bernie: duration, laser-on time, lengths, bounds.bernie gcode project.bernie -o job.gcode: the job's G-code (on the output without-o).bernie graver project.bernie --ouiand a target:--port /dev/ttyUSB0(GRBL laser over USB,--debitfor the speed),--reseau 192.168.1.50(networked GRBL),--hub bernie-link.local --code CODE(shared laser: a project is prepared by Bernie Link with the device it keeps),--octoprint http://octopi.local --cle KEY,--duet http://duet.local [--mot-de-passe PASSWORD]. A.gcodefile goes as is. **--ouiis required: without it, nothing is sent. The command follows the progress to the end; Ctrl-C** stops the job. English option names also work (--yes,--device,--serial,--network,--key,--password).- Device:
--appareil(name in the library,.jsonfile of a device, or catalog identifier —bernie machines), otherwise the one kept by the project, looked up in the Mac app's library or in--bibliotheque devices.json|bundle.bernielot(a settings bundle exported from Bernie Studio or the desktop app). - Variable text:
--serie 42(counter, serial numbers),--csv data.csv;--nomgives the job name. --json: results in JSON (one line per progress update); exit codes 0 (done), 1 (refused), 2 (malformed command).bernie appareils,bernie machines,bernie portslist the devices, the catalog machines and the serial ports.
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
- Glasses rated for the wavelength, for you and anyone present.
- Never leave the laser running unattended; keep a fire extinguisher within reach.
- Ventilate: some materials release toxic fumes (PVC, vinyl and anything containing chlorine must not be engraved).
- Manual fire is disabled by default; allow it only at low power, for positioning.
- Make the first tests of a new device on the virtual laser, then at low power on a scrap.
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.
| Symptom | Lead |
|---|---|
| Nothing is engraved | Layer sent to the laser (bolt)? Power not zero? Closed shapes on a fill layer? See the pre-flight check. |
| The job leaves the work area | Absolute coordinates: the design must be on the bed; reduce overscan or speed. |
| Darker edges on fills | Turn on automatic overscan. |
| Every other line shifted | Set the device's scanning offset. |
| Engraving mirrored or upside down | Laser › Check Device Orientation. |
| Engraving upside down or mirrored | Check the machine origin in the profile. |
| Power too strong or too weak | Profile S max equal to the controller's $30. |
| The laser stays on between shapes | Turn on laser mode ($32=1) or tick “GRBL without laser mode”. |
| Wrong estimated time | Enter 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.
- Menus: at the top, File (new project, new window, templates, open, save, import, import a 3D model, art library, trace images, export to G-code, Ruida, SVG, DXF, PDF or Illustrator, print, notes), Edit (undo and history, clipboard, selection, group, lock), View (fit workspace, preview, 3D simulation, rulers, filled display, fast outlines, text size, language) and Help (manual, shortcuts, “My job is…”) and Feedback (share feedback, report a bug, waiting feedback). Shortcuts are shown next to the commands; with the keyboard, the arrows move from one command and one menu to the next. Undo, redo and the preview stay on the right of the bar.
- Browser: Chrome or Edge on a computer to use everything (drawing uses WebGPU, otherwise WebGL2 — older graphics cards included); Safari and Firefox display and edit, without a USB connection to the laser.
- Tablet and phone: on a narrow screen, the layers and the Laser panel move below the work area; on a phone, the edit bar fits on one line that scrolls with a finger and the title gives way to the menus. On the work area: one finger draws, selects and moves like the mouse; pinch to zoom and drag with two fingers to pan, without changing the drawing; a long press opens the context menu (like a right-click); a double tap on a text edits it.
- Laser: Laser tab › Serial Port… (WebSerial: the browser asks which port to open) or Virtual laser to try everything without a machine — its engraving is drawn on the bed. The same rules as in the app apply: a confirmation before each job, STOP always available, jobs or framing outside the work area refused.
- Files: Open and Import use the browser's file picker; Save and exports are downloaded. Dragging a file onto the page opens it (project, settings bundle) or imports it (design, image, LightBurn project…). Pasting (⌘V or Ctrl+V) an image or an SVG copied in another application imports it; shapes copied in Studio paste as before. Computer fonts load through Computer fonts… (Chrome, Edge). A project changed since it was saved is not lost by accident: New, Open, a template or closing the tab ask for confirmation. New window opens another project in a new, independent tab — with its own laser (one serial port per tab).
- Kept in this browser: device profiles, material libraries, macros, templates, art library, job log, language and display settings. To move them to the app or another browser: Device › Settings bundle… (
.bernielot); private browsing forgets them when closed. - Third-party licences: link in the help window — the open-source components included in Bernie Studio and their licences.
- Camera: Camera tab — the browser's webcam (the browser asks for permission) or a photo of the bed; calibration with the 9 engraved crosses then clicked in the image; the corrected image under the design (opacity, offset, continuous update) and insertion into the project. The calibration is kept in this browser. As on the Mac: automatic alignment with the coded markers, Calibrate Lens… (target shot at several spots in the view), When panel opens (nothing, update image, continuous update) and Captures (size, time, rate, failures). Several cameras: Camera list (New…, Rename…, Delete), each with its webcam and alignments; Included in the global image: with at least two cameras included, Update image takes one image per webcam and overlays them (a camera without alignment is reported and skipped; the bed photo only serves the chosen camera). Material height (one alignment per thickness, Other height, Interpolate between aligned heights). Animations follow the system's "reduce motion" setting; Fast outlines (View menu) lightens the display of very large designs.
- Differences from the Mac app: no shortcut settings; the manual opens with Help and the shortcut list with ? or F1.
Bernie Studio shortcuts (⌘ on Mac, Ctrl elsewhere):
| Shortcut | Action |
|---|---|
| V, R, E, P, L, T, N, X, M | Select, Rectangle, Ellipse, Polygon, Path, Text, Nodes, Trim, Measure tools |
| ⌘Z, ⇧⌘Z (or ⌘Y) | Undo, redo |
| ⌘X, ⌘C, ⌘V, ⇧⌘V, ⌘D | Cut, copy, paste, paste in place, duplicate |
| ⌘A, ⇧⌘I | Select all, invert selection |
| ⌘G, ⇧⌘G | Group, ungroup |
| ⌘L, ⇧⌘L | Lock, unlock |
| ⇧⌘], ⇧⌘[ | Bring to front, send to back |
| ⌫, arrows | Delete, move the selection |
| ⌘S, ⌘O, ⌘I, ⌘E | Save, open, import, export G-code |
| ⇧⌘P | Job preview |
| ?, F1 | Keyboard 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.
- Laser: Laser tab › pick the port in the list (USB ports first, with the manufacturer's name), ↻ reads the list again after plugging in the machine, then Connect. The link goes through the system: no browser port picker, and the same safety rules (confirmation before each job, STOP always available). For a Wi-Fi or Ethernet laser (grblHAL, FluidNC, serial-to-Wi-Fi bridge): Network, then its address (
host:port; without a port, 23 then 8080) and Connect; the choice and the address are remembered for next time. Search the Network lists the lasers that announce themselves (Bonjour, Telnet service) and GRBL boards on ports 23 and 8080 (MKS DLC32…): a click fills in the address. The Virtual laser is still there to try everything without a machine. - Files: Save and exports open the system's Save dialog (folder and name); Open and Import, drag and drop and pasting work as in Bernie Studio.
.bernieprojects and.bernielotsettings bundles also open with a double-click (or "Open with", or dropped on the icon): if Bernie is already running, the file opens in the window already open, which comes to the front. For a second launch to open its own Bernie instead, uncheck File › Open in the Running Window. Bernie Studio installed as an app (Chrome, Edge) also opens these files in its window. - Ruida controllers (CO2 lasers): Find My Laser recognises them over USB (FTDI chip: Bernie reads the board ID, without moving anything, and never sends them GRBL commands) and on the network (same read, sent to the addresses of the computer's network and to 192.168.1.100, the factory address); the controller can also be chosen under “Your machine” for a CO2 laser. The Laser panel of that device then sends jobs to the controller: Network link (IP address) or USB (the controller's port, cable in its “PC” socket, not the USB stick one), test the connection, frame, information, stop, Send and start below the warning. File › Export › Ruida over the network… does the same for any device — see “Ruida machine files”. USB on Ruida controllers is experimental: not tried on a real machine yet. A web page cannot talk to the controller: only the desktop app, or Bernie Studio served by Bernie Link (network).
- Windows: File › New window opens another project in its own window; File › Close Window (Ctrl+W, ⌘W on Mac) or the window's close button ask for confirmation if the project has changed since it was saved. The manual and the licence notices open in a Bernie window, links to websites (manufacturer, donation) in the computer's browser.
- USB driver: with a CH340 or CP2102 chip on the laser's board, Windows may need the manufacturer's driver (see Troubleshooting and “My job is… › The laser does not connect”). On Linux, the user must belong to the group that can access serial ports (often
dialout): “Find My Laser” reports a denied port and gives the command (sudo usermod -aG dialout $USER, then log out and back in). - Raspberry Pi: tried on a Raspberry Pi 5 running Debian 13 (Raspberry Pi OS 64-bit, Wayland or X11 desktop); it needs WebKitGTK:
sudo apt install libwebkit2gtk-4.1-0. On the same machine, Bernie Link shares the laser with the other devices (see Bernie Link). - Third-party licences: shipped with the application (
THIRD-PARTY-NOTICES.txt); Help › Bernie manual › Desktop app licences shows them.
Keyboard Shortcuts
You can change shortcuts in Settings › Shortcuts (on iPad: Preferences › Keyboard Shortcuts):
- click a command's shortcut box, then type the new key combination (Esc to cancel); the search field finds a command by name or by shortcut;
- a menu command needs ⌘ or ⌃ (or a function key); a canvas tool takes a single letter or digit, without modifier keys, so it never gets in the way of typing text;
- if the combination is already in use, Bernie tells you and offers to reassign it: the other command loses its shortcut;
- ✕ removes a shortcut, ↶ restores the default one; "Restore All Default Shortcuts" undoes every change;
- ⌘. (laser stop), the File menu commands, Undo, Redo and system shortcuts cannot be changed;
- changed shortcuts are included when you export your preferences.
Default shortcuts:
| Shortcut | Action |
|---|---|
| V, R, E, P, L, T, N, X, M | Select, Rectangle, Ellipse, Polygon, Line, Text, Nodes, Trim, Measure tools |
| I, S, C, B, F | Node tool: insert, smooth node, corner node, break path, close path |
| L, S, A, T, E | Node tool, segment under the pointer: straighten, smooth curve, align, trim, extend (they take priority over the tools while editing nodes) |
| Tab, Shift-Tab | Next, previous object |
| ⌘Z, ⇧⌘Z | Undo, redo |
| ⌘X, ⌘C, ⌘V, ⌘D | Cut, copy, paste, duplicate |
| ⌥⌘V | Paste in place |
| ⌘A | Select all |
| ⇧⌘I | Invert selection |
| F1 | Help on what you are doing |
| ⌘G, ⇧⌘G | Group, ungroup |
| ⇧⌘H, ⇧⌘V | Flip horizontal, vertical |
| ⇧⌘A | Array |
| ⌘L, ⇧⌘L | Lock, unlock |
| ⇧⌘], ⌘], ⌘[, ⇧⌘[ | Bring to front, bring forward, send backward, send to back |
| ⌫ | Delete the selection |
| Arrows (Shift: large step) | Move the selection |
| ⇧⌘K | Insert a code |
| ⌘I | Import |
| ⌘E, ⇧⌘E | Export G-code, export SVG |
| ⌥⌘U, ⌥⌘-, ⌥⌘I | Union, subtract, intersect |
| ⌥⌘O | Offset path |
| ⌥⌘P, ⌥⌘B | Convert to path, break apart |
| ⌥⌘J, ⌥⌘D | Rebuild curves, delete duplicates |
| ⌥⌘T | Trace image |
| ⌥⌘L | Material library |
| ⇧⌘R | Rotary |
| ⌘=, ⌘-, ⌘0, ⇧⌘0 | Zoom in, out, show the bed, show the selection |
| ⌘', ⇧⌘' | Snap to objects, to the grid |
| ⌥⌘F | Filled display |
| ⇧⌘P | Job preview |
| ⌘. | Stop the laser |
| ⌘, | Settings |
| ⌘R | Show or hide the rulers |
| ⌥⌘ arrows | Move the laser head by one step |
No results.