SVG
Scalable vector artwork. Often useful for laser design workflows. Physical size can depend on width/height units and application import behavior.
Practical troubleshooting for LightBurn, XCS, connection problems, laser output, cutting, engraving, Air Assist, smoke, focus, camera alignment, and positioning.
xTool problems can originate from software, USB or network connection, machine configuration, focus, optics, material, laser output, Air Assist, ventilation, positioning, or camera and framing systems. Features differ across models, so confirm what yours actually has.
FIND MY PROBLEMEXPLORE DESIGNEROOH FILESLightBurn / XCS / USB / Network
02Communication / computer / software
03Output / software / machine
04Focus / material / output / speed
05Focus / speed / output / image
06Pump / hose / airflow
07Ventilation / duct / airflow
08Noise / airflow / obstruction
09Focus / material height
10Lens / focus / output
11Origin / workspace / coordinates
12Alignment / calibration / workspace
13Connection / machine detection / workflow
14Device setup / communication / workspace
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
NO → USB, network, cable, software, device configuration. YES → continue.
NO → machine connection, software, configuration.
YES → check device configuration and communication.
NO → output, layer, configuration, protection, model-specific hardware.
NO → focus, material, output, speed, passes, lens, Air Assist.
Focus, speed, output, material, image, lens.
Air Assist, exhaust, fan, duct, ventilation.
Origin, workspace, coordinates, machine position, camera/framing if applicable.
Machines differ in laser type, power, enclosure, camera, Air Assist, exhaust, autofocus, positioning, software workflow, and connection method. Identify your exact model first. These cards list what to look at, not specifications.
Diode laser workflow, LightBurn/XCS, USB, cutting, engraving, Air Assist, focus.
Enclosure, positioning, autofocus where applicable, XCS, LightBurn where applicable, ventilation, cutting/engraving.
CO₂ workflow, XCS, LightBurn where applicable, cooling, ventilation, cutting, camera/positioning where applicable.
Dual-laser workflow where applicable, software, positioning, engraving, focus, material selection.
Model-specific laser system, software, positioning, engraving, focus, material workflow.
Only the laser functions apply here; non-laser features are outside this guide.
Connection depends on USB communication, machine detection, device configuration, controller communication, model compatibility, and connection stability. Not every xTool model is guaranteed to work with LightBurn, so check compatibility for yours.
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Machine not detected is a power, cable, or network problem. Detected but XCS cannot communicate is usually device selection, software version, or a stale session. Connection methods vary by model.
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
If the computer never sees the machine, work through power, cable or network, port, and operating system detection. Connection type varies by model.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Connecting then losing communication points to stability: unstable USB or network, computer sleep, power management, software, controller, firmware, or the computer environment.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Possible causes: machine not ready, software output disabled, layer configuration, incorrect device configuration, protection system, overheating, or a model-specific hardware issue.
| Symptom | Possible Cause | Check |
|---|---|---|
| Moves, no laser | Output/configuration | Layer/output |
| No communication | Connection | USB/network/software |
| Intermittent | Protection/connection | Stability |
| Weak | Focus/optics | Focus + lens |
| Stops mid-job | Controller/protection | Machine status |
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Results depend on exact model, laser technology, power, material, thickness, focus, speed, output, passes, optics, Air Assist, and flatness. There is no universal xTool speed or power number.
| Symptom | Possible Cause | Check |
|---|---|---|
| Cuts partway | Speed/output/focus | Test grid |
| Uneven cut | Flatness/focus | Material height |
| Heavy charring | Passes/airflow | Passes + Air Assist |
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Vary OUTPUT down rows and SPEED across columns; use PASSES as a third variable in a second run. Illustrative only, with no real values.
Settings are machine and material dependent.
Causes: speed too high, output too low, incorrect focus, dirty optics, image contrast, dithering, engraving mode, material surface, module condition, or Air Assist.
| Symptom | Possible Cause | Check |
|---|---|---|
| Very light | Speed/output | Settings |
| Uneven | Focus/material | Flatness |
| Low contrast | Image prep | Contrast/dithering |
| Weakened over time | Optics/module | Lens |
| Excess smoke | Airflow | Air Assist/exhaust |
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Air Assist moves smoke and debris away, supports cleaner cuts, and can help manage flare-ups in appropriate setups; it does not solve every cutting issue. Causes: pump, hose, nozzle, airflow, power, or model-specific configuration.
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Air Assist and exhaust are different systems. Air Assist blows air at the cut; exhaust removes smoke and fumes. Causes: blocked exhaust, poor duct routing, weak airflow, enclosure leakage, fan obstruction, excessive smoke, or poor airflow direction.
Safety: never exhaust hazardous fumes into occupied indoor spaces, and never assume a laserable material is safe.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Causes: dust, debris, obstruction, loose component, worn fan, restricted airflow, or overheating. Noise types: rattling (loose part), grinding (bearing or obstruction), buzzing, clicking, vibration (mounting or imbalance). Do not attempt motor repairs.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Focus affects cutting depth, engraving sharpness, line quality, and energy concentration. Causes: incorrect focus, material height, uneven material, wrong autofocus procedure, configuration, or model-specific autofocus behavior. Not all models share one system.
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Causes: dirty optics, focus, output settings, overheating, module condition, material, or protection behavior.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Causes: origin, workspace settings, coordinates, machine position, framing, camera alignment, mechanical movement, or software configuration.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
Camera and framing features vary by model; do not assume identical behavior. Issues include preview mismatch, framing mismatch, calibration, workspace mismatch, camera position, material placement, and enclosure or environment changes.
The exact procedure can vary by xTool model. Check the documentation for your specific machine before changing firmware, electrical components, controller settings, wiring, or safety systems.
Collect: exact xTool model, laser type/power if known, XCS version, LightBurn version if used, operating system, connection method, any error message, whether the machine is detected, when the problem started, whether it happens every time, and steps already tried. Support can narrow causes much faster with this information.
USB · Network · XCS · LightBurn · Device Configuration
Firing · Output · Layer · Protection · Machine Status
Focus · Speed · Output · Material · Optics
Origin · Camera · Framing · Air Assist · Exhaust
More guides coming: SCULPFUN Troubleshooting · ATOMSTACK Troubleshooting · Creality Falcon Troubleshooting · Glowforge Troubleshooting · Laser Cutting Problems · Laser Engraving Problems · Laser Smoke & Ventilation Problems
Check power, the cable or network path, computer detection, and software device selection. Connection methods vary by model, so confirm yours in the documentation.
Check the device configuration for your exact model, the selected connection or port, cable stability, and whether your model is supported by LightBurn.
Check power, connection method, device selection, and XCS version compatibility. Restart XCS and the machine, and note any error message.
Look at connection stability, computer sleep, other software, and compatibility. Test a short job and avoid long jobs until it is reliable.
Yes. A damaged, charge-only, or loose cable can cause failed or intermittent connections, so test a known-good data cable and port.
Check power, machine status, output and layer settings, protection warnings, and overheating. If hardware failure is suspected, stop and contact support.
Check focus, material and thickness, speed, output, passes, optics, and Air Assist, then run a small material test. Settings differ by model.
Common causes are incorrect focus, speed too high, output too low, dirty optics, low image contrast, or a resistant material. Change one variable at a time.
Yes. Poor focus spreads the beam's energy and weakens cuts and engraving. Focus and autofocus procedures differ by model.
Yes, contamination can reduce energy reaching the material. Clean only using the manufacturer-approved procedure for your exact model, with the machine off and cool.
Check power, hose connections, kinks, nozzle blockages, and the air path. Setups vary by model; stop if you suspect electrical or mechanical damage.
Check the exhaust path, ducting, fan, enclosure leaks, and airflow direction. Air Assist is separate from exhaust, and hazardous fumes must never be vented into occupied indoor spaces.
Power down and look for dust or obstruction. If the fan is hot, smells burnt, or still sounds abnormal, stop and follow manufacturer guidance.
Check workspace configuration, origin, coordinates, and mechanical movement, plus camera and framing alignment if your model has them. Test small first.
Camera features vary by model. Confirm support, workspace dimensions, material placement, and calibration using your model's instructions.
Use the software your model officially supports and your documentation recommends. They behave differently, so do not assume settings transfer.
Not as a first step. Check connection, configuration, focus, and settings first, and update only if the manufacturer documents it for your model.
Models differ in laser type, power, optics, focus, and Air Assist, so settings are not transferable. Run a material test for each machine.
Once your xTool is connected, focused, and cutting consistently, explore digital laser-cutting designs for creative projects and makers.
EXPLORE DESIGNEROOH FILES →FREE DESIGN FILE TOOL
Check file dimensions, convert units and prepare a resized SVG or raster image before opening it in your laser or CNC software.
SVG/raster processing + basic ASCII DXF geometry import · 81 machine profiles
Maximum file size: 10 MB. SVG, DXF and PNG/JPG/WebP work is processed in this browser. Other formats (SVGZ, AI, EPS, PDF, PLT, HPGL, BMP, TIF, TIFF, GIF) are sent to the DESIGNEROOH conversion service when selected.
Reported dimensions are separated from assumptions.
Enter the physical size you want the exported file to represent.
For SVG, resizing changes physical width/height while preserving the viewBox coordinate system. Unlocking aspect ratio may stretch the design. SVG effects, strokes, text, clipping, patterns and filters can render differently across applications.
Choose an output format, then apply dimensions. DXF output supports basic SVG geometry only; other formats are produced by the conversion service.
Convert a measurement without uploading a file.
Use explicit target dimensions when the source file does not declare a reliable physical size.
The viewBox describes drawing coordinates. The SVG width and height describe its displayed canvas size. A file with only a viewBox does not reliably tell us the intended real-world size.
Important: this tool cannot verify the result inside VCarve. Always measure the imported vectors before machining.
Search your own verified database or use general workflow guidance.
Loading machine profiles…
Know what a file contains before sending it to a machine.
Scalable vector artwork. Often useful for laser design workflows. Physical size can depend on width/height units and application import behavior.
Common CAD exchange format. Unit conventions and supported entities vary. ASCII DXF import supports LINE, CIRCLE, ARC (approximated as line segments), LWPOLYLINE without bulge arcs, POLYLINE and POINT. Other entity types are reported as skipped.
May contain vector paths, raster images, or both. Page size is not necessarily the design bounds. PDF processing is handled by the conversion service.
Made of pixels. Useful for image engraving; pixel count and DPI determine an assumed physical size. Raster images are not cutting vectors.
Plotter vector formats used by some cutters and engravers. Conversion is handled by the conversion service; verify units and line settings in your software.
Search common problems and follow the next checks.
Check the job units, then measure a known vector. If the source has no physical units, enter the intended width or height explicitly and scale in VCarve or use the SVG resize controls above.
Check whether inches were interpreted as millimeters or vice versa. 1 inch equals 25.4 mm. Confirm the selected job units before scaling.
Use the units configured for your job and workflow. Avoid switching units mid-workflow without checking dimensions. 1 in = 25.4 mm; 1 cm = 10 mm; 1 m = 1000 mm.
SVG viewBox coordinates are not automatically millimeters or inches. Check width/height and units, import dimensions in your design software, and measure a known edge before machining.
Check the exporting application's DXF version, units, scale, layers and entity support. This browser tool does not modify DXF files; re-export from CAD software or inspect in a trusted DXF editor.
Identify the software/controller workflow first. Import a design into supported design/CAM software, then export or generate the machine-specific job format required by that workflow.
Preview rendering may not match every application's treatment of fonts, strokes, filters, clipping or embedded resources. Open the downloaded output in your intended software and verify dimensions.
Use SVG or DXF for clean vector cutting paths and PNG/JPG for image engraving. PDF, AI and EPS can hold vectors but should be checked after import. Always confirm which formats your laser software accepts.
Start with the product's included format list. Choose SVG for supported vector workflows, DXF for compatible CAD/CAM software, and raster images for image engraving. Check the listing and your software's import requirements.