> For the complete documentation index, see [llms.txt](https://gathery.gitbook.io/softwareguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gathery.gitbook.io/softwareguide/lightburn.md).

# LightBurn

LightBurn

## Instructions of LightBurn

Applicable models: ALL

### Download

Download website:<https://lightburnsoftware.com/pages/trial-version-try-before-you-buy> And you can find Lightburn Software installation packages and CH340 driver installation packages in the TFcard. Please install CH340 driver before you use Lightburn.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2F59MuiqNectXNvSNFtx9Q%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.29.12.png?alt=media&amp;token=e24e8d61-113f-4818-b4d7-f5a361e1aaea" alt=""><figcaption></figcaption></figure>

Double-click the program installation file to install, and click in the pop-up window, until the installation is completed. (Note: LightBurn is a paid software. For a better experience, we recommend that you buy the original version. We will demonstrate the installation of the trial version here.)

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FcafKEvva7PvqJRKd7qgT%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.30.00.png?alt=media&amp;token=299b8c9f-e956-451c-8df1-1a3248ab80e5" alt=""><figcaption></figcaption></figure>

### Add Devices

Click. Then Click at the bottom right of the software to add laser. Next, there are two creation methods, we recommend the first one. Method 1: Click , then find and import the configuration file in the TF card. The File Name is Woxcker （model name）\_Lightburn\_Configuration.lbdev. It contains adding laser and configuring parameters.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FaqsTbO8ZDF0Yv6zUddJJ%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.31.26.png?alt=media&amp;token=c19390bd-cada-4373-8169-4dd48080a42a" alt=""><figcaption></figcaption></figure>

Method 2: Click . Then Click . If there are two types of DSP and GCode,

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FrJrr2SVTT3RAKa3XuhHG%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.32.16.png?alt=media&amp;token=9b717f5d-214e-488c-b4c3-770078b4358a" alt=""><figcaption></figcaption></figure>

Click.When the window appears“GRBL-Serial/USB …”,click. After a successful connection, the console will display code: Grbl...ok , and it display: Laser Ready. If the software does not automatically connect to the laser engraver, you need to choose the port of the laser engraving machine as shown in the figure 26.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FuttOlTTJLgEeTqU7tbgv%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.32.53.png?alt=media&amp;token=0ed76c6e-efe5-4ba2-8ec6-7d4af1f8a994" alt=""><figcaption></figcaption></figure>

If you did not find the laser, please add the laser manually. Click .Choose one of the . Choose \<Serial/USB>. Name your laser, and set the X and Y axis to 400mm.Set the laser to the Front left.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FVmDDZdo5rD7TejMWaRwJ%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.33.45.png?alt=media&amp;token=f5090f48-0427-4014-9dcb-275092c7451d" alt=""><figcaption></figcaption></figure>

### Engraving Settings

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FWNgYXf8ipSbW41iwmndL%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.34.34.png?alt=media&amp;token=f437d70f-939b-418a-b7ba-8079b7a9fd7e" alt=""><figcaption></figcaption></figure>

Speed: the speed at which the laser moves. We recommend using mm/m, if your machine shows mm/s, you can change it in -.&#x20;

Pass Count: the number of laser passes.&#x20;

Power Max/Min: the laser power, it is recommended not to exceed 90%.&#x20;

Interval: the interval of laser lines, the smaller the interval, the deeper the engraving effect. When cutting material, change the mode in - \<Convert to cut(debug)

### Button Description

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FmU2UnLnhLTP1jeFrUbTu%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.36.19.png?alt=media&amp;token=a47d071d-8ca9-4082-855a-92db91ee7540" alt=""><figcaption></figcaption></figure>

Stop: Stop laser processing&#x20;

Start: Start laser processing&#x20;

Square Frame: Scan a frame with a square path&#x20;

Circular Frame: Scan a frame with a circular path&#x20;

Save GCode: Save the current task as a GCode project file&#x20;

Run GCode: Run GCode file&#x20;

Home: Reset to the origin set by&#x20;

Go to origin: Go to the origin set by

### Device Settings

Double-click "Speed/Power" to adjust more parameters of the task, including mode and Kerf offset, etc.&#x20;

In \<Edit>-\<Device Setting>, you can set more details of the machine. Please refer to the settings of our pictures.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FPy28NhJEt2itOhtnJBi7%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.38.22.png?alt=media&amp;token=4751cb62-cee6-4154-bc5c-4442f59c47e5" alt=""><figcaption></figcaption></figure>

### Lightburn camera setting

Because the camera of the machine will be offset during assembly, you need to set the offset of the camera in the LightBurn software. How to operate

1. Open LightBurn—click\<window> in the navigation—click \<Camera Control>.
2. Open the pictures in the folder \<LightBurn Camera Setting> in the TF card—set the parameters of \<Camera control> to be consistent with the parameters of the folder pictures.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FKTp8u3BO7PgeHyWQDKFn%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.40.47.png?alt=media&amp;token=e1bc063b-634f-4d01-bd8d-caf1b1c76450" alt=""><figcaption></figcaption></figure>

### Lightburn camera setting

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2Fv4QXcrOBdJLVRnTK1LDX%2F%E6%88%AA%E5%B1%8F2024-07-26%2015.41.27.png?alt=media&amp;token=c8e1f8f6-7aac-4214-a10a-3c0c0818e055" alt=""><figcaption></figcaption></figure>

Limited to Lightburn software, please connect your computer and the machine using a Camera-PC cable. If you encounter any issues, refer to the official Lightburn tutorial videos on YouTube by searching for "lightburn camera."

Role of the camera:

1.Swiftly locate engraving positions. With proper camera calibration, the deviation between the engraved position in the software and the actual position is within 1mm, enhancing efficiency, especially in scenarios involving mass engraving of identical items.&#x20;

2.Save materials by precisely positioning engraving patterns in the software, reducing material wastage.

In case of inaccurate camera positioning, calibration is necessary (Note: Calibration is performed before factory shipment, but machine movement during transportation may cause misalignment). The calibration steps are as follows:

1.Calibrate the camera lens to collect data for compensating lens distortion.&#x20;

2.Align the camera through engraving patterns for precise positioning calibration.