When LightBurn's camera alignment or calibration won't work, it's rarely one thing — the capture can come back black even with a good live preview, the Capture button can do nothing, the wizard can refuse the printed pattern, or the overlay can look perfect while the engraving still lands off. Below are the nine causes that come up most often on the LightBurn forum, each with the specific fix and a link to its source, including the ones answered by LightBurn's own staff.
The camera shows a normal live image, but the Capture Image step in the Camera Alignment or Lens Calibration wizard returns a solid black or blank frame, so the wizard can't finish. This is the single most-reported camera-alignment failure, and it hits Windows hardest on LightBurn 1.7 and 2.0.
Open Settings and change the Camera Capture System, then retry — on current LightBurn switch Recommended to Fallback; on older versions switch Default to Custom (or vice-versa). On a Mac, also check System Settings, Privacy & Security, Camera, and make sure LightBurn is allowed. If it's still black, exit LightBurn and unplug/replug the camera's USB, then capture again — it sometimes takes a couple of tries. When nothing else works, a known-good older version (1.6.03) or even a different, slower PC has captured successfully where a new machine failed; you can also export the camera settings from a computer where it worked and import them on the one that won't.
The live view is fine, but clicking Capture in the wizard produces no reaction and no error message.
This is almost always the Camera Capture System set to Custom — change it (try Default or Fallback) in Settings and the button starts working. If the captured image then looks very dark, switch the camera image from Full Color to Black and White.
The wizard won't accept the printed circle pattern, can't find the circles, or the captured calibration image comes out curved or warped.
Cover a honeycomb bed before capturing — the holes get read as extra circles and confuse the detector. Glue the printed pattern to wood or foam board so it's perfectly flat; any curl is read as lens distortion. Keep the card still and in focus (set it down, don't hand-hold it), and face it square to the camera: directly at a fisheye lens, or flat and parallel to a standard lens.
The live image looks okay to your eye, but the wizard never recognizes the pattern, and the camera resolution shown is low (for example 320x240).
If the camera runs through a USB extender or a USB-over-Cat6/ethernet adapter, it can starve the bandwidth and drop the camera to a resolution the wizard can't use — USB is only rated to about 3 meters (16 feet), so plug the camera straight into the computer with a normal cable. On LightBurn 2.x the old dot pattern is deprecated: run the newer AprilTags lens calibration instead of the dots.
Calibration completes but the overlay is skewed or mirrored — the marks don't map to the right corners.
In the alignment step you double-click the center of each target in its exact numbered order; tagging them out of sequence misaligns everything. Re-run the alignment and tag 1-2-3-4 in order, and never move the engraved target pattern after it's burned — its position in the bed is what the alignment is measured against.
The capture isn't black from a software fault — the engraved pattern just doesn't stand out, because the board is dark or the bed is dimly lit.
Use a light-colored board for the calibration burn (dark masonite doesn't give enough contrast), and add bright, even lighting — one operator only got a clean capture after shining an LED work light across the bed.
After calibrating, marks line up horizontally but sit high or low — one user was off by about 1/8 inch vertically while side-to-side was fine.
Make sure the top of the material is at the laser's focus height for both the alignment test and the real job. If the camera is on the lid, it must return to the exact same position every time you close it — a loose lid or mount shifts the result. Then fine-tune with the X Shift / Y Shift values in the Camera Control window and click Save.
No matter how often you re-run it, the camera misses by roughly the same large amount (for example an inch high), and changing the Y value in the panel has no real effect — a sign the stored calibration is corrupt.
Camera calibration is stored per device, so delete the machine from your Devices list and add it again as a fresh device, then re-run both calibration steps. Reinstalling LightBurn alone won't clear it; recreating the device does — that's what finally fixed it for a user who had fought it for months.
Jogging the laser to a point on the camera overlay is accurate, but running an actual job shifts the whole design off position.
Check the pointer offset in Device Settings — xTool's supplied configuration enables it by default, and leaving it on throws the camera alignment off; disable it and re-run the alignment. Also confirm the item's top is at the same focus height as when the alignment cut was made, since a different material height moves where the job lands on the bed.