---
description: LaserGRBL
---

# LaserGRBL

## Instructions of LaserGRBL

Applicable models: ALL

### Download

LaserGRBL is a free and open source software. Download website: http://LaserGRBL.com You can also find LaserGRBL Software installation packages and CH340 driver installation packages in the TF card.

### Installation

Double-click the exe format file you downloaded to start the software installation, and keep clicking until the installation is completed. The installed software is shown as the figure 2.

<div align="left"><figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FJrVnqOJaMnMAumt1oz25%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.04.44.png?alt=media&#x26;token=8bc85acc-fbb9-4847-b519-65e6b4d81dd0" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2Fzt4cNBpPZJAZUg7FN3Qt%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.06.02.png?alt=media&#x26;token=c0bfa978-00a9-4bf2-9f05-d1b2e98b2b28" alt="" width="375"><figcaption></figcaption></figure></div>

### Custom buttons

When some buttons of the software do not appear, such as the zero reset button.You can import buttons manually. Download link: https://lasergrbl.com/usage/custom-buttons/ You can also find custom buttons packages in the TF card.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FNeNAhnutc0NdrGzGGvLI%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.07.45.png?alt=media&#x26;token=6ed44084-3716-476f-bf02-a29301b89e93" alt="" width="375"><figcaption></figcaption></figure>

Next, import the custom buttons into LaserGRBL. Open the LaserGRBL program, right-click inthe blank area next to the button at the bottom (as shown in Figure 4), then choose , and select the custom button zip file downloaded before to import, keep clicking Yes (Y) until there is no popup.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FQQM7NgHSy7ee5cDPqvrp%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.08.42.png?alt=media&#x26;token=30d87722-d0be-447c-9784-c5bf82499925" alt=""><figcaption></figcaption></figure>

### Install the driver

Connect the laser engraver to a computer with USB cable. Plug in the power adapter of the laser engraving machine. Open LaserGRBL. Install CH340 Driver. In LaserGRBL, click to install the driver, and restart the computer after installation.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FCo5THI3W49uOFHcjCDKo%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.10.38.png?alt=media&#x26;token=85abaa73-d27d-49d0-9dec-8c36a17cf6fa" alt="" width="375"><figcaption></figcaption></figure>

### Select the COM port

Select the correct port number and baud in the software- 115200 (In general, COM ports do not need to be selected manually, but if you have more than one serial device connected to the computer, it needs to do so, you can find the port of the laser engraving machine in the device manager of the Windows system, or you can simply try the port numbers displayed one by one).

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FJsv5cF3W7QFqj6uQEFYw%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.12.53.png?alt=media&#x26;token=afc24913-aae5-4944-8d30-19817dc46877" alt=""><figcaption></figcaption></figure>

Click on the lightning connection button in the software. When the lightning button changes to a red, the connection is successful. On the bottom-right of the LaserGRBL interface you should read "Status: Idle".

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FSDYsGHwZY9gSy7LX7PWh%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.14.10.png?alt=media&#x26;token=537c541f-2e9a-4aad-b383-f62caebe6032" alt=""><figcaption></figcaption></figure>

### Instructions of buttons

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2F03Dp9yvg00EKaQsijwxe%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.16.05.png?alt=media&#x26;token=ba03e870-f1bf-4c25-b0bd-da2e0b003680" alt=""><figcaption></figcaption></figure>

### Import the file

To achieve a stable engraving effect, please import the default machine configuration file in the TF card into LaserGRBL before engraving. The configuration file corresponding to LaserGRBL is **woxcker\_L8 MAX\_GRBL\_Configuration.nc**

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FIw5eUEceIgrPzWzIJvSg%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.17.51.png?alt=media&#x26;token=7633077d-d16f-4419-a40b-3dc9140a5bb8" alt=""><figcaption></figcaption></figure>

Selecting the engraving file. Open LaserGRBL,click , then select the images or file. LaserGRBL supports NC, BMP, JPG, PNG, DXF and other formats.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FRjMkqLrte9p0RAOUjgLI%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.18.55.png?alt=media&#x26;token=9e7a0abd-f010-4deb-bb76-29629b88bbad" alt=""><figcaption></figcaption></figure>

### Engraving parameter introduction

a) You can adjust the brightness, contrast, white clip of the image. When adjusting the parameters, the factual effect will be shown in the right preview window.

b) "Line To Line Tracking"and "1bit BW Dithering" as engraving mode; "lbit BW Dithering"is more suitable for engraving grayscale images; "Vectorize" or "Centerline" mode is used to cut the material.&#x20;

c) "Quality" represents the interval of engraving lines, the larger the value, the narrower the interval.&#x20;

d) In the preview window, the red lines represent the path of the laser movement.&#x20;

e) At the bottom of the preview window, the image can be rotated, mirrored, cut, etc.&#x20;

f) After completing the above settings, click button to the settings of engraving parameters.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FwK8aiQqDqgygyzkeQNF0%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.20.56.png?alt=media&#x26;token=fcee1282-61cb-462b-8e7a-ee8092ce60ed" alt=""><figcaption></figcaption></figure>



### Engraving parameter settings

Choose different speeds and engraving power according to the hardness of different materials.&#x20;

a) Engraving speed: The larger the value, the faster the engraving speed, the shallower the laser traces; The smaller the value, the slower the engraving speed, and the deeper the laser traces.&#x20;

b)Laser Mode: M3 - Constant power mode. M4 - Dynamic power mode. Note: If your M4 laser mode is not available, please check your GRBL configuration to make $32=1.&#x20;

c) S-MIN is the minimum power, set it close to S-MAX; S-MAX is the maximum power, the recommended value should not exceed 90%, which prolong the life of the laser.&#x20;

d) Set a suitable size according to the size of your engraving material.&#x20;

e) Finally, click on the button to complete the setting of all engraving parameters.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2F9zbM2At1JQQKNrwSaCjN%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.24.00.png?alt=media&#x26;token=4b1f0881-9e90-4ef4-9598-cad455fad367" alt=""><figcaption></figcaption></figure>

### Homing to zero

Home laser. Click the HOME/Zero button, the laser will move forward to the front left. After homing, the default engraving origin is from the front left, and the engraving object needs to be placed along the origin. Note: If the laser is not homed, it may cause the laser to exceed the working area.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2Fj6iZtUZIojhpBOiEPMNC%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.37.56.png?alt=media&#x26;token=55bcf076-15c7-4401-8652-749540596b6d" alt=""><figcaption></figcaption></figure>

### Frame

Click the button, the laser will start to scan the outer frame of the image. You can adjust the position of the engraving object according to the scanned frame area.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FVaW6UQtLfkdUvfg2rAan%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.38.54.png?alt=media&#x26;token=a96da73b-9b80-4956-a7ef-370b5eba9d1c" alt="" width="375"><figcaption></figcaption></figure>

### Start and stop engraving/cutting

Start engraving/cutting&#x20;

After completing all the above settings, click the green button as shown in the Figure 16 to start engraving/cutting. There is an editable number next to the start button, and this number is the times of engraving /cutting. LaserGRBL allows multiple consecutive operations on the same image. This function is especially useful for cutting.&#x20;

Stop engraving/cutting&#x20;

If you want to stop engraving/cutting while the machine is running, you can click the stop button as shown in the Figure 17 to stop engraving/cutting.&#x20;

Feed hold and resume&#x20;

If you just want to pause while the laser is running and will resume unfinished work, you can click the feed hold and resume button as shown in Figure 18.

<figure><img src="https://1580175134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEQJIlfNDUxoLbWDnXkfB%2Fuploads%2FGtOzYeDXW0CXxX4qmROd%2F%E6%88%AA%E5%B1%8F2024-06-17%2015.40.20.png?alt=media&#x26;token=9b55461f-4b2d-4b31-bd4f-b7455161345d" alt=""><figcaption></figcaption></figure>

