Bernie User Guide
What’s New
The latest features, newest first, each with a link to the section of the manual that explains it.
The latest features, newest first (details in the sections linked).
- Move arrows: they follow the device origin — “→” goes right and “↑” goes to the back, seen from the front, even when the origin is on the right or at the back (they used to go the wrong way); Laser panel, shortcuts, numeric keypad, assistants and shared laser — see The Laser panel.
- Gweike Cloud (Cloud, Cloud Pro, Cloud Basic II, Cloud Pro II) in the catalog: Ruida controller connected over USB (Mac, Windows, Linux, or Bernie Link on a Raspberry Pi); Material Thickness in the job placement: the head goes down 17 mm minus the thickness to focus, then back up (experimental, not yet tried on a real machine) — see “Laser panel of a Ruida device” in Files.
- What goes to the laser, before starting: above Start, the Laser panel shows each layer sent with its speed, power and passes, the layers left out, the job size and its placement (start from, job origin). Clicking a layer opens it in the Layers tab, clicking the placement unfolds its settings; the start question repeats this summary — see The Laser panel.
- Roland and Brother ScanNCut cutters: an HPGL cutter can also be connected over the network (IP address, port 9100: Roland GR2 and GS2, Summa, GCC…), over printer-class USB with no driver (Mac, Linux), or through the maker’s Windows printer driver; the network also works on iPad and iPhone. Brother ScanNCut: an
.fcmfile for every ScanNCut, to copy to a USB stick — see Cutters and Plotters. - Networked xTool: M1, M1 Ultra, P2, P2S, F1, F1 Lite, F1 Ultra and F2 Ultra in the catalog, controlled over Wi-Fi or the USB cable (network); D1, D1 Pro, D1 Pro 2.0 and S1 over Wi-Fi too. Address, connection test, confirmed Start…, pause, resume, stop and machine state in the Laser panel; a virtual machine to try it out — see Networked xTool. AtomStack: the whole range in the catalog, P1, Swift, Kraft, Glacier and Hurricane at 460,800 baud — see Devices.
- Ruida laser panel: Start… and Send to Controller… at the top, each with its confirmation; a job origin of your choice (the head at the workpiece’s bottom left corner, the frame and the job “rise” above it), Trace the frame at low power when the red pointer is missing, Move the head live with the machine’s arrows (network), machine settings moved to the device settings, explanations as tooltips — see “Ruida machine files” in Files. Speed units (per second or per minute) also in Bernie Studio and the desktop app; the checklist before each job is on by default, and optionally before turning on the laser for focusing; a pictogram shows each layer’s mode, and an offset-fill layer shows nested outlines in filled display.
- 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.
This manual is also built into Bernie: press F1, or open the Help menu, to read the topic for what you are doing. A mistake, a missing answer? Tell us
Try it in Bernie, for free.
Free laser engraving and cutting software for diode, CO2, fiber and galvo lasers. Windows, Mac, Linux, iPad, iPhone and in the browser.