If you haven’t yet, download the right gSender file for your operating system. Links to common computer downloads and all other types and versions of gSender can be found on the main page:

Note that as of version 1.2.2, support for 32-bit systems and Windows 7/8 has had to be dropped since new software packages can no longer support systems 10+ years old.

If you downloaded the more experimental ‘gSender Edge’, then remember to also read what features it uniquely offers and how to use them:

Windows Install

You may run into a security warning from your computer when you download the .EXE file. This can be bypassed by selecting “See more.” You can choose to keep the download, so that it can continue to run.

Microsoft Edge Users: If you are having difficulties downloading gSender when using Microsoft Edge, follow the instructions here or watch the video here.

Once you’ve downloaded the EXE file, double-click to run it. gSender isn’t yet set up to pass security checks so you’ll have to allow it to run manually by clicking ‘More Info’ and then clicking ‘Run anyway’. If you don’t feel that you can trust gSender, then no pressure to use it; we’ll have this setup later on.

If the “More info” option isn’t available, it could be that Windows is fully blocking installation. This can be fixed by going to “App & browser control” and switching “Check app and files” to “Warn” or “Off” just for the installation of gSender. You can always turn it back on afterwards.

With permission to run, you should be met with a license agreement. gSender is provided “as is” which means there’s no expectation that it’ll run your CNC perfectly – especially as it’s still in very active development. We want you to understand this before moving forward. If you agree, you’ll be able to choose your install options from there (who to install for and where) and then begin installing.

Install completion will be indicated by a completion screen. If the ‘Run gSender’ box is checked off you should be able to click ‘Finish’ and be greeted with a splash screen followed by the full program. If not, you can always open the program manually after install.

Mac Install

Once you’ve downloaded the DMG file, double-click to run it. A window will popup that will look like the one below. Click and drag the gSender app and let go the applications folder to save it to your Mac.

Navigate to your applications folder on your Mac and the gSender program should be there and ready for use.

If you’re having issues installing gSender on your Mac:

  1. Open System Preferences.
  2. Go to the Security & Privacy tab.
  3. Click on the lock and enter your password so you can make changes.
  4. Change the setting to ‘App Store and identified developers’
  5. After, you’ll see the option to override app blocking by clicking the temporary button to ‘Open Anyway’
  6. You’ll be asked one more time if you’re sure, but clicking Open will run the app.


You can run gSender by using Linux inside of ChromeOS. Setup Linux on your Chromebook with these instructions. Download the .appimage file from the latest release of gSender and double click to launch. You will need to have the g-code files you want to carve in the same folder too.

gSender Updates

Most systems are set up so that each time gSender has a new update available, there will be a notification on the program that allows you to quickly download the latest version. If you’re not receiving these update notifiers, your system is not yet supported but you should still be able to download the newest version manually and install it over-top of the old version.

Note: If you are upgrading to a new version or gSender, or downgrading to an older version, and you run into problems trying to get it to open or run, you’ll want to find a file called “.sender_rc” and rename it. This will allow gSender to generate a new version and clean up any errors you may be encountering. Renaming the file allows you to recover your old Start/Stop events and macros from the file in the future if needed.

  • For Windows: the file can usually be found on your hard drive, at: C:/users/{your username}/.sender_rc. Rename it to whatever you like, like “.sender_rc_old”, then try to reinstall gSender again.

  • For Mac/Linux: the file is in the home directory as a hidden file. You can either:
    • Go to your Home directory in Finder and make sure you have ‘show hidden files’ enabled (CMD + Shift + . ). You’ll then be able to see the file and rename it.
    • Go into the Mac/Linux console and enter the command “mv ~/.sender_rc ~/.sender_rc_old”. You’ll be able to double check the renaming was successful by sending “ls -al | grep sender” in the console, where if you only see “.sender_rc_old”, you have successfully remanded and are ready to try to reinstall gSender.

Pi Install

If you’re considering a Pi setup, that’s great! There are a lot of potential perks that can come from having a cheap, mini, fanless computer to run your CNC without the downside of Windows updates and other quirks. A couple things you should know though before diving in:

  • While most gSender users run simple 64-bit Windows or Mac based systems, RasPi is a whole other world of hardware and software configurations, making it really hard for us to offer all possible installs or help troubleshoot the variety in setups
  • RasPi OS builds have been going through a large fluctuation recently swapping from 32-bit based to 64-bit which is still causing compatibility issues in the community since some libraries have kept up and others haven’t, this has introduced a whole new variable of matching up OS install with software build and has eventually forced upon us the ability to only support 64-bit
  • RasPi compatibility is ultimately something that we built due to community demand but still don’t use much ourselves. In addition, anyone who tends to use RasPi likes to troubleshoot things themselves meaning that it’s hard for us to know if we’re missing anything in our instructions

We hope all of this explains why you’ll find the RasPi side of gSender support is inherently the least well documented of all the install options. We’ve tried our best to cover some of the more common setups, but we’d still recommend you have some familiarity with Linux if you continue with this installation since our support won’t be able to cover the many specific problems of various Pi builds.

Starting notes:

  • We provide 2 different variations of Pi binary – .AppImage, .deb.
  • Pi versions are all indicated by the “Pi-64Bit” tag in the executable name.
  • Supported PI OS (Raspbian/Pi OS):
    • To determine which OS you’re running, enter a terminal and type “cat /etc/os-release”. The name and pretty name should verify your OS and version

For most simple Pi setups, you’ll want to:

  1. Download the AppImage
  2. Right click and go to the permissions tab
  3. Make sure “executable” permission is set on the file
  4. Run the program

Default Pi credentials:
User: pi

These are needed when performing ‘sudo’ super user access, a type of administrator access needed to alter system-specific things. Once you’re set up with your Pi we recommend creating a new user account with different credentials as a security precaution, especially if you’re running gSender in remote mode or connecting your Pi to the internet. If these credentials don’t work for you then either check with your manufacturer or congratulations you’ve already created your own account and changed the default password 😉

To change the default pi user password. It’s just menu -> Preferences -> Raspberry Pi Configuration and then the “Change Password” option


Error log location:
All application logs can be found in “~/.config/gSender/logs” and can be shared for any app-specific problems.

Common Issues

Sizing for Smaller Screens
gSender can size responsively but only to a minimum point. Because of this, some Pi users might find gSender isn’t fitting their screen properly. This can be accommodated on most Pis by:

  • Click the Pi icon on the top right
  • Preferences -> Screen configuration -> Configure -> Screens
  • Click HDMI-1 (or whichever screen that is connected to the Pi), then you’ll find you can select your Resolution
  • We’d suggest you choose a minimum resolution of 1280×1024. Once chosen, you should be able to verify if this fix has worked for you or you can go back and continue to tweak it as needed.

This should allow gSender to show on your screen fully without it being cut off.

Visualizer is blank
This is most likely related to webGL not being enabled. You can check inside Chromium/Chrome by visiting and checking that both WebGL 1 and WebGL 2 have the green ‘supported’ banner. If these aren’t present, then to enable webGL:

  • Inside Chrome/Chromium, navigate to chrome://settings
  • In the ‘System’ section, ensure the “Use hardware acceleration when available” checkbox is checked
  • Relaunch Chrome for the changes to take effect then go to chrome://flags
  • Ensure that “Disable WebGL” is not activated
  • Relaunch Chrome for the changes to take effect and now these updated settings should be used by gSender’s Electron builder

Can’t open the port to connect
Make sure your user is part of the dialout group. To add your account to this group, go to a terminal and type “sudo usermod -a -G dialout <user>” (replacing “<user>” with your username). Restart after this change and try again.