Skip to content

Bernie User Guide

Bernie for Windows and Linux

Bernie Studio in an application window for Windows and Linux: direct USB and network connection, system file dialogs, Ruida sending and Raspberry Pi.

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. .bernie projects and .bernielot settings 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), Start… or Send to Controller…, frame (and trace the frame), move the head live (network), information, test, stop, job origin. 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.

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.