Skip to content

Bernie User Guide

Troubleshooting

Start from what you see: “My Job Is…” and the symptom table give the likely causes and the tools to fix them; share feedback in seconds.

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.

Bernie's “My Job Is…” window: “Not enough energy for this material”, with the checks to make and buttons for the material test and the controller settings.
“My job is…”: from what you see to the setting to change.

Damaged or oversized file

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

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

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

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

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

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

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.