Having troubles with gSender or have suggestions to improve it? Here are the steps you can follow:
- Questions or suggestions are always welcome!
- If you’re having a problem, first help us out by ensuring that it’s not an issue on your end with your computer or CNC. If you can try with another computer or g-code sender and still see the same problem then certainly let us know.
- If you’re sure about the issue, and have already checked our docs, YouTube playlist, and Common Problems & Fixes below, give us a hand by sending us as much information as possible so we can help diagnose your problem more easily.
Information to Send
In order of importance, please collect together information of:
- Your computer Operating system and gSender version
- Please connect to your controller, try to recreate the issue, and as soon as it happens again create a ‘Diagnostic PDF‘ to send to us. If you can generate this shortly after the issue that’s ok too, but it won’t allow us to help you if you’re not connected to your machine or you generate it too long after you had the issue happen. Find this by clicking on the ‘Calibrate’ tool in gSender, then clicking the ‘Download Now!’ button in the bottom, right corner and saving it on your computer.
- gSender Settings, get these by going to Settings and locating the “Export Settings” button, then saving the file on your computer.
- Machine Firmware, get these by going to the ‘Firmware’ tool and clicking the button for “Export Settings”, then saving the file on your computer.
- Your g-code file if you’re seeing the problem only with a specific file
- Any other pictures or videos of the problem can also help us to help you faster
Please attach the files and information in your post / email to us.

Questions or Suggestions
Send us the information, questions, or suggestions either on:
- The gSender Forum
- Github page (feel free to also submit PRs)
- You can join the discussion on secondary communities like our Facebook gSender Group, and Facebook CNC Group, but we can’t provide as much support or hear feedback in these groups.
Common Problems & Fixes
We’ll continue keeping our ears out for common stumbling points while using gSender and ensure we address them here for quick reference. If these tips don’t help you, remember you can contact our support if you have a CNC from Sienci Labs or contact your own manufacturer’s support for instructions on fixing your machine.
Issues downloading or opening gSender
- The main cause of this is usually a “virus protection” or Firewall software on your computer, or your computer system itself, thinking that gSender is ‘unsafe’ even though it’s a proven software. In cases like these, first find the source of the blocking and then either make an exception for gSender or disable the blocking temporarily during download and installation.
- An example of this is if you see “Windows cannot access the specified device, path, or file. You may not have the appropriate permissions to access the item.”
- For Windows-based computers you can read more on it here: https://support.microsoft.com/en-us/topic/-windows-cannot-access-the-specified-device-path-or-file-error-when-you-try-to-install-update-or-start-a-program-or-file-46361133-47ed-6967-c13e-e75d3cc29657
- If gSender used to open fine but after an update it suddenly doesn’t, check here since the update might’ve gotten corrupted: https://resources.sienci.com/view/gs-installation/#gsender-updates (scroll past the first picture)
- If when you open gSender it gives you an error along the lines of “Entry Point Not Found“, this means that you’re trying to use a version of gSender past 1.2.2 with a 32-bit system. If you want to resolve this you’ll either need to continue using a version of gSender 1.2.2 or earlier, or change to using a 64-bit system.
Screen goes Blank
If you find that gSender goes blank after you open it or while using it, there are a couple things you can try.
- Try to close and reopen gSender. If it makes a black screen again, then close and open gSender again ➜ Go to the settings ➜ Export your current settings if you care about them and want to later reload them ➜ then “Restore Default settings”. After doing this it’s more likely you won’t have an issue again.
- If you’re using gSender Edge, you’ll see a toolbar at the top of the app where you can click: View ➜ Toggle Developer Tools ➜ then look at the ‘Console’ where if you find any errors you can share these with us. Also if you click: View ➜ Reload, you’ll be able to refresh gSender to not show the blank screen anymore.
- Otherwise if you’re using the main version of gSender, you can try updating to the latest version.
- Check your antivirus software or Windows Defender and add gSender as an exception.
- Check to ensure you have read/write permissions for the preferences file
- Let’s locate the file! It’s called .sender_rc and can usually be found on your hard drive at: C:/users/{your username}/.sender_rc
- Right-click on the file and choose properties. Under the security tab, check the name of your profile and confirm you have full control of the file.
- If not, select edit, choose your computer name, and grant permissions.
- Let’s locate the file! It’s called .sender_rc and can usually be found on your hard drive at: C:/users/{your username}/.sender_rc
- If you’re still getting a blank screen, locate your log file and send it in to us. It’s located at: C:/Users/{your user name}/AppData/Roaming/gSender/Logs/main.log
Use gSender without a CNC
It’s not easy for us to simulate how a real CNC will behave if you’re not connected to one, but luckily there are some workarounds:
- Buy a cheap “Arduino Uno”: this board is the ‘brain’ that runs many Hobby CNCs and can be easily found online or in some stores for around $10. Once picked up you can connect it to your computer over USB, flash Firmware onto it to make it behave like a CNC, then you’ll be able to connect to it in gSender. There are limitations such as not being able to home or probe (any sensor inputs) unless you manually short them together yourself; and this is because obviously you’re not connected to a real CNC.
- Use a file simulator: this won’t let you pretend to run your CNC in gSender, but can simulate how a cut might turn out. You can read more about these options here.
Connects but status says Disconnected
If your machine connects on a COM port successfully but the machine status says “Disconnected” then this is not an issue with gSender. A ‘Disconnected’ status means that gSender isn’t able to recognize your CNC even though it can see it.

- Check that you have the right settings for your board, for instance click Settings ➜ Baud rate where most boards use 115200. Also your machine might not be supported yet by gSender if it isn’t using grbl or grblHAL or your manufacturer edited the core firmware too much.
- Your board may have a faulty connection. Try unplugging it then plugging back in, use a different USB cable, a different USB port on your computer, or plug the cable directly in if you were using a USB hub.
- Your board might have other loose connections. Power off your machine, then use a non-conductive tool like a plastic utensil to push down on all 4 corners of your control board shield or Arduino. For the LongBoard you don’t need to open it, just flip it upside down and you’ll be able to access the Arduino through the slats on the bottom. Doing this will ensure that everything is fully plugged in since sometimes if the Arduino is slightly off the control board it can mess with its communication.
- Your board might have corrupted firmware. Re-flash your board if it’s a LongBoard, SLB, or by following your manufacturers instructions.
- At the least when you plug the board to your computer over USB you should hear a ‘connection’ sound from your computer. You should also see a new device appear under the Devices and Printers on your computer. If none of these are happening, then that means your computer isn’t recognizing the board so you might want to look at drivers or getting further technical support.
My CNC Profile is not listed
Much of the information that gSender needs about your CNC actually comes from its built-in EEPROM values, so the CNC profiles don’t have any impact. This means that as long as your CNC is grbl-based, gSender should be able to control it just fine, even if it’s not listed in the presets. Selecting the “Generic” preset will work just fine.
If some aspects of your machine don’t seem right, it’ll either be because your machine’s manufacturer didn’t flash your CNC with the appropriate EEPROM settings out of the box or they have some type of documentation which explains the values you need to change manually.
Port not Found (3018 CNC)
The 3018 and similar variations have been tested to work with gSender. Sainsmart points out in their documentation that sometimes an additional driver is needed for your computer to recognize the CNC via the USB port. They make this driver available for download here.
In case this link stops working, the associated documentation can be referenced here.
For most of their machines they recommend using a 115200 baud rate, so double-check you’re using that value as well.
Port not Found
As long as your board is running normal grbl or grblHAL and you’ve selected the correct Baud rate in the settings then connection should be possible. Double-check that you’re not connected to your machine elsewhere like with:
- Other senders like Easel, CNCjs, UGS, Lightburn (some programs might auto-connect so you might have to close them entirely)
- Pendants or offline controllers since typically a sender and controller can’t be used at the same time
- Other programs like Arduino IDE or STMCubeProgrammer
We’re still working on making gSender work best across all devices and one aspect of this is port detection for a variety of CNCs. If your CNC still isn’t showing up on the port detector, we’d really like to hear from you.
One key bit of information that we need on our end is a picture or screenshot of your device information. You can get to this screen by:
- Make sure your CNC is plugged into your current computer via USB
- Open “Device Manager” in your Windows start menu
- Expand the “Ports (COM & LPT)” heading
- Find the listing related to your CNC. This will be the one that disappears and reappears if you unplug your CNC and plug it back in. It’ll also be the port you normally connect to on other g-code senders.
- Right click that device and open “Properties”
- Open the “Details” tab at the top
- In the “Property” dropdown, select the “Hardware Ids” option
- Send us a picture of the final view. An example of what that might look like would be:
We appreciate your feedback, and with your help we’ll make sure the next version of gSender recognizes your machine.
File is Tiny in Visualizer
You’re probably using the wrong post processor, go back and check what your CNC manufacturer recommends. By default it’s best to use “grbl_mm” even if you like to use inches since most CNCs work in mm.
Jogging not working, I get an Error
If you’re seeing a message in the ‘Console’ tab saying “error: Bad number format”, this is because you’re running an older grbl machine (pre Grbl 1.1f). Contact your CNC manufacturer or look through their resources to see how you can upgrade your grbl firmware so that your machine can be fully supported by gSender. If you have a Sienci Labs machine, this is as easy as using the ‘Flash grbl’ option in the ‘Firmware’ tool in gSender.
Alternatively, you could be getting an error for ‘soft limits’. If this is the case then either your machine limits have been set incorrectly or you didn’t home your CNC when you first connected to it. Try homing your machine and trying again, and keep an eye out for if you’re only having this issue in certain parts of your cutting area.
Gamepad Error or Inconsistent Jogging
If you can’t access your gamepad shortcuts or there’s a problem with the profile, the easiest way to fix it is to delete the profile and remake it. This can suck depending on how much you customized it, and we’ll keep working to make this process work better into the future.
If you can connect and jog with your gamepad but the jogging is sometimes unpredictable, then the problem might actually be the gamepad itself. Go to Settings ➜ Shortcuts ➜ Gamepad ➜ Gamepad Profile ➜ and click the ‘Help’ button at the top of the window. This will take you to a 3rd party Gamepad Tester website (that you can also visit at https://hardwaretester.com/gamepad) where you can try pressing buttons and moving joysticks to see if they’re all behaving properly. If anything seems out of place then you might want to try using a different gamepad to control your CNC.
Changes between “Running” and “Idle” during a Job
This is Normal. Sometimes there can be pauses or long changes in direction in the g-code that can make the machine state change in this way.
Workspace changes during/after a job
If your g-code includes any workspace commands from G54 to G59, G59.1 to G59.3, or has an M2 or M30 command at the end of the program this will alter your selected workspace either to the one specified or revert it to G54. These commands affect how grbl stores the active workspace and so also affect the workspace stored by gSender. If you’re experiencing this issue then you’ll want to check your CAM post processor and ensure that it stops inserting these commands when you export your g-code jobs.
Alternatively, gSender’s ‘Start/Stop G-code’ can also be equipped to sidestep problems with changing workspaces by saving the active workspace at the start of the program and then re-loading it at the end. This can be done with the commands %global.state.workspace=modal.wcs
and [global.state.workspace]
as shown in the picture below. Remember to ‘Update Event’ on both entries:

Changed $1 and Motors still Hold
This is a quirk of grbl boards where after changing this value you need to make a motor movement (a jog movement for example) before the new value will take effect.