Kerf Bridge
Free · Raspberry Pi, Windows, Mac, Linux
New: Kerf for iPad beta — testers wanted →

Your laser, on the network.

Kerf Bridge plugs into your GRBL laser's USB port and puts it on your Wi-Fi. Run it on a Raspberry Pi beside the laser, or on any PC that's already there.

Send a whole job and the bridge runs it itself, so a sleeping laptop or a dropped connection never stops a burn. It has its own web page to check on the laser from any browser, and LightBurn connects to it like any network laser.

How Kerf Bridge connects A computer or iPad talks over Wi-Fi to the bridge, which talks over USB to the laser. Laptop or iPad Kerf Bridge Pi or PC USB GRBL laser

Kerf for iPad — beta testers wanted

Design and burn from an iPad: draw with Apple Pencil, import SVG, DXF and PDF, engrave photos, and send jobs to the bridge. Line work up on the material with the bridge's camera, and start from the maker's own settings for popular lasers. It'll be on the App Store as Kerf: Laser Engraver. The bridge will stay free.

Try the beta

How it works

The bridge holds the laser's USB port open, so opening and closing connections never resets the controller. It finds the laser by itself and reads its bed size and settings.

1

Job mode

Upload a whole job and the bridge streams it to the laser itself. Close the lid, walk away, check progress later. Pause, resume and stop work from anywhere on the network.

2

Works with LightBurn

Pass-through on TCP port 23, like ser2net. In LightBurn, add the laser as GRBL with an Ethernet/TCP connection and type the bridge's address.

3

Its own web page

Open the bridge's address on port 8023 in any browser: the laser's state and position, a big STOP button, jogging, job progress, uploading G-code and settings.

4

Finds the laser

Plug the laser in and the bridge looks for it on the usual USB serial chips (CH340, CP210x, FTDI, Arduino, ESP32, STM32). It reads the bed size and full-power setting from GRBL's $$.

5

One controller at a time

Whoever starts a job owns the laser until it ends. Anyone else can watch, and anyone can always stop it.

6

Found automatically

The bridge announces itself on your network (Bonjour), so apps can list it without anyone typing an IP address.

7

A camera over the bed

Plug a USB webcam into the Pi and point it at the bed. Watch a burn live on the bridge's web page, or full screen in Kerf. The camera is only on while someone is watching.

8

Home Assistant

Give the bridge your MQTT broker and it appears in Home Assistant by itself: the laser's state, job progress, time left and the bed camera, with Stop, Pause and Resume buttons. Stop always works, so an automation can stop the laser.

9

Line work up by camera

With Kerf for iPad, burn a grid of dots once and the camera is lined up with the bed. After that, the camera's view sits under your design, true to size, and Kerf can find the piece you've laid down and fit your work to it.

Download

Free. One small program, nothing else to install. Version 0.5.0.

Raspberry Pi and Linux

Any Raspberry Pi 3, 4 or 5 (or Zero 2 W), or a Linux PC. Installs as a service that starts when the Pi does.

curl -fsSL https://trykerf.com/install.sh | sh

Run it again to update. If port 23 is already taken (ser2net, say), the installer leaves that alone and puts LightBurn pass-through on 2323.

New to it? The set-up guide goes through it step by step, including how to read the installer before you run it. The installer and the bridge's source are on GitHub.

Windows

Windows 10 or 11, 64-bit. Plug the laser into this PC and run the bridge.

It isn't code-signed yet, so Windows may warn you: choose More info → Run anyway, and allow it through the firewall so the network can reach it. Then open http://localhost:8023.

Mac

macOS 13 or later, Apple silicon and Intel. A menu bar app, signed and notarised by Apple.

Open the download, drag Kerf Bridge to Applications and open it. A bolt appears in the menu bar: Open Kerf Bridge… shows its page, and Start at Login keeps it running. The first time, the set-up wizard opens by itself.

Check the download

Every file is listed with its SHA-256 checksum. The Pi installer checks it for you.

Settings live in /etc/kerf-bridge/config.json on the Pi, and in your user settings folder elsewhere. The web page can change them too.

Build 02d59b0. Supports GRBL 1.1 lasers (most diode lasers and many CO₂ conversions). Ruida controllers aren't supported.

Using it with LightBurn

  • In LightBurn, open Devices → Create Manually and choose GRBL.
  • Pick Ethernet/TCP and enter the bridge's address (the Pi's IP, or the PC's), port 23.
  • Set the bed size to match the laser. The bridge's web page shows it if you're not sure.
  • While LightBurn is connected it controls the laser. Other apps and the web page can still watch and press STOP.

Why a bridge?

  • A laser streamed over Wi-Fi stops dead if the connection drops or the laptop sleeps. In job mode the bridge holds the whole job, so it can't.
  • Connecting to a laser's USB port usually resets it. The bridge keeps the port open, so connecting and disconnecting doesn't.
  • The laser can live in the garage or workshop, and you send jobs from the house.

Questions

Which lasers does it work with?

Lasers with a GRBL controller on USB: most diode lasers (Ortur, Atomstack and Sculpfun among them) and machines converted to GRBL. If LightBurn connects to it as a GRBL device, the bridge will too. Lasers with a Ruida controller, or that only connect over the maker's own Wi-Fi, aren't supported.

Which Raspberry Pi do I need?

Any Pi 3, 4, 5 or Zero 2 W running Raspberry Pi OS, 32- or 64-bit. The bridge uses very little; a Pi already doing something else is fine.

I already use ser2net for LightBurn. Do I need to change anything?

The bridge replaces ser2net and does the same job on port 23, plus job mode and its web page. Stop ser2net (sudo systemctl disable --now ser2net), then run the installer; or install alongside it and use port 2323 until you switch.

Which cameras work?

Almost any USB webcam: the bridge needs one that sends MJPEG, which nearly all do. Plug it into the Pi running the bridge and mount it looking down at the bed; the bridge finds it by itself. The camera works on a Pi with a 64-bit OS and on Linux PCs; the Windows, Mac and 32-bit Pi versions don't have it yet.

How do I add the bridge to Home Assistant?

You need Home Assistant's MQTT broker (the Mosquitto add-on) and a Home Assistant user for the bridge to log in as. On the bridge's web page, under Settings → Home Assistant, enter the broker's address, that user's name and password, and save. A Kerf Bridge device then appears in Home Assistant with its sensors, buttons and camera. Nothing to install in Home Assistant.

Is it safe to leave a job running?

Never leave a laser unattended. The bridge makes jobs reliable, not safe: stay with the laser, keep a fire extinguisher nearby, and use the STOP button or the laser's own emergency stop if anything looks wrong.

How do I update it?

On a Pi, run the install command again; your settings are kept. On Windows, download the new version and run it in place of the old one. On a Mac, quit Kerf Bridge from the menu bar, then drag the new one to Applications and open it. Restarting the bridge resets the laser's controller, so home the laser again afterwards.