Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A Java based GRBL compatible cross-platform G-Code sender.
nesC Java Other
Branch: master

Universal GcodeSender is a Java based GRBL compatible cross platform G-Code sender. Use this program to run a GRBL controlled CNC machine.

To run simply unzip the .zip file and double click the .jar file. On some platforms you will need to run an included start script.

Note for MAC users: For version 1.0.8 and earlier you may need to create a "/var/lock" directory on OSX to fix a bug in the serial library. To do this open the Terminal application and run the following two commands:
sudo mkdir /var/lock
sudo chmod 777 /var/lock


2.0 Nightly builds build status: Build Status

  • Currently under heavy development, feedback and suggestions are helpful!
  • classic GUI - The classic UGS GUI.
  • UGS Platform - This is a work in progress. The next generation platform-based GUI utilizing the UGS API.

Stable builds
1.0.8 - The last stable build before 2.0 work.
1.0.7 - Requires Java 7 or higher.
1.0.6 - Requires Java 6 or higher.
Older releases can be found on the downloads page

1.0.8 Known issues

  • The visualizer does not work on OSX. (resolved in nightly build)

Command table tab during a file send 3D Visualizer Window Finished sending a file Finished sending a file

Technical details:

  • JSSC for serial communication (RXTX was used up through v1.0.8)
  • JogAmp for OpenGL.
  • Utilizes One-Jar to bundle all dependencies into a single runnable .jar file.
  • Developed with NetBeans 8.0.2 or later.
  • To build a release using Netbeans open the 'Files' pane and right click build.xml, then select 'Run Target' > 'onejar-build-release'. A new directory named 'release' will contain the .zip file.


For development the Maven build tool is used.

Run main class from command line

mvn exec:java -Dexec.mainClass="com.willwinder.universalgcodesender.MainWindow"

Execute all tests

mvn test

Just build a self-running uber-jar:

mvn package

Build a release file

mvn package assembly:assembly


1.0.8 -> 2.0

  • New serial library: JSSC
  • TinyG support enabled.
  • Translations: French, Greek, Dutch

1.0.7 -> 1.0.8

  • PendantUI server - connect to UGS with your smartphone or tablet. (jvabob)
  • Translations: German, Spanish, Italian, Afrikaans
  • Many bugfixes and stability improvements.

1.0.6 -> 1.0.7

  • Many improvements to code architecture to allow future support for multiple firmwares (TinyG, Marlin, Smoothie, etc).
  • New menu bar! Now new features can be added and existing features are more configurable.
  • Additional on-the-fly gcode command preprocessing:
  • - truncate and round long decimals to configurable length.
  • - enforce max command length.
  • - remove whitespaces.
  • - expand small arcs to G1 commands.
  • New option to save preprocessed gcode file to a file.
  • Visualizer navigation controls - pan and zoom with the mouse wheel. (michmerr)
  • Visualizer Support for radius arcs (phlatboyz sketchup plugin gcode now displays correctly)
  • New single-step mode.
  • New colored status indicator.
  • Many bugfixes, thanks to UGS contributors

1.0.5 -> 1.0.6

  • 3D gcode visualizer!
  • - color coded line segments
  • - real time tool position
  • - real time gcode buffer position
  • Due to popular demand, RaspberryPi support.
  • Complete all-in-one release, 32 and 64 bit linux/windows/mac + RaspberryPi
  • Settings saved between runs (thanks lazyzero)
  • Advanced GRBL control, new buttons for GRBL 0.8c features (gcode check mode, homing, etc)
  • Major backend refactoring to make code more stable and testable.
  • Unit tests added, over 1300 lines of unit test code.

1.0.4 -> 1.0.5

  • Job duration estimate now displayed when running a file.
  • Real-time machine position display for GRBL v8.0c.
  • Display for most recent GcodeComment.
  • Bug fixes - no more dropped commands!
  • Overhauled the GUI to display more information.

1.0.3 -> 1.0.4

  • The step size spinner now goes to less than 1.
  • New buttons on the manual control page for common functions.
  • Manual X/Y coordinates can now be modified with arrow keys.
  • New start scripts added to release zip files.
  • Changed speed override to a percentage rather than absolute.
  • Bug fixes.

1.0.2 -> 1.0.3

  • Manual jogging mode, control machine with buttons in the UI.
  • Automatically skip blank lines and comments when sending a file.
  • Bug fixes.

1.0.1 -> 1.0.2

  • Grbl version checking.
  • Real-time pause/resume commands used for Grbl v0.8.
  • Comment filtering - parses out comments before sending commands.
  • Bug fixes.

1.0 -> 1.0.1

  • New distribution jar - Application no longer requires RXTX to be installed!
  • Added table view for file streaming.
  • Added Pause/Resume button.
  • Usability improvements.
  • Many bug fixes.
  • Renamed package to com.willwinder.universalgcodesender.
Something went wrong with that request. Please try again.