Skip to content
A Java based GRBL compatible cross-platform G-Code sender.
Branch: master
Clone or download
Pull request Compare This branch is 60 commits behind winder:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Universal G-Code Sender

Universal G-Code Sender is a Java based, cross platform G-Code sender, compatible with GRBL and TinyG/g2core. Use this program to run a GRBL or TinyG/g2core controlled CNC machine.

Online documentation and releases:
Discussion forum:!forum/universal-gcode-sender

Technical details:


These are the nightly builds of the most recent code with the latest features and bug fixes.
For stable releases visit the downloads page.

Last commit Build Status Codacy Badge Codebeat badge

Version Description
UGS Classic The nightly build of the classic version with a clean and lightweight user interface
UGS Platform The nightly build of the next generation, feature packed version based on the Netbeans Platform


Make sure you have Java 8 or later installed.

Download either UGS Classic or UGS Platform and unzip the .zip file.

  • For UGS Classic simply double click the jar file. On some platforms you may need to run the included start script.
  • For UGS Platform run the start script: bin/ugsplatform


UGS Platform

UGS Platform main window

UGS Platform

Customizable panel layout

Customizable panel layout

Menu actions with customizable keybindings


Menu with plugins


One of many plugins

Dowel Maker

UGS Classic

UGS Classic main window

Classic main window

UGS Classic with visualizer

Classic visualizer


For development the Maven build tool is used.

Start the application

UGS Classic:

mvn install
mvn exec:java -Dexec.mainClass="com.willwinder.universalgcodesender.MainWindow" -pl ugs-core

UGS Platform:

mvn install
mvn nbm:run-platform -pl ugs-platform/application

Execute all tests

mvn test

Building the self-executing JAR

mvn install
mvn package -pl ugs-core

Build a release file

mvn package assembly:assembly


1.0.9 -> 2.0

  • Constant memory! Optimized every part of UGS to run in a fixed amount of memory, no more slowness because a file is too large.
  • 'Cancel' now issue a feed hold and soft reset to stop the machine faster.
  • Macro substitutions. Use {machine_x/y/z} {work_x/y/z} to substitute the current machine/work coordinates, {prompt|name} can be used to ask for values in a popup dialog.
  • UGS now queries GRBL for its current state and settings in order to configure itself in a more intelligent manner. (Thanks Phil!)
  • Improved gcode parser. Heavily refactored and validated with a new suite of unit tests, the gcode parser is now much more powerful than before and can be augmented customizable command processors.
  • Controllers can now be added and configured with a JSON file, see resources/firmware_config
  • Added restore default buttons on settings pages.
  • Plane selection support: G17, G18, G19
  • Setup wizard for CNC controllers
  • Improved support for TinyG / g2core

1.0.8 -> 1.0.9

  • Many performance improvements.
  • New serial library: JSSC
  • Updated 3D library.
  • Maven build script (Thanks nitram509!)
  • TinyG support enabled.
  • XLCD support.
  • Bug fixes: INCH/MM jog units, visualizer fixes (crashes and OSX support), "Null stream" error, localization crashes,
  • Translations: French, Greek, Dutch, Italian

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.
You can’t perform that action at this time.