GCodeZAA — GUI Fork

This is a fork of Theaninova/GCodeZAA adding a graphical user interface (GUI) and pre-built installers for macOS, Windows and Linux. All credit for the core ZAA algorithm goes to the original author.

Downloads

Platform	File
macOS Apple Silicon (M1/M2/M3/M4)	GCodeZAA-macos-arm64.dmg
macOS Intel	GCodeZAA-macos-x64.dmg
Windows 10/11 x64	GCodeZAA-windows-x64-Setup.exe
Linux x86_64	GCodeZAA-linux-x64.AppImage
Linux ARM64 (Raspberry Pi 4/5)	GCodeZAA-linux-arm64.AppImage

👉 Latest release

What's new in this fork

• Graphical user interface — drag & drop G-code, select STL folder, one-click processing
• Pre-built installers — no Python setup required, download and run
• Log panel — real-time processing output with color coding
• G-code analyzer — instant slicer detection, layer count, object count
• Multi-platform CI — GitHub Actions builds for every release

GUI Usage

1. Download and install the package for your platform above
2. Launch GCodeZAA
3. Drop your .gcode file into the input area (or click to browse)
4. Set the STL folder — directory containing the STL files matching your print objects
5. Click ▶ ZPRACOVAT GCODE (Process G-code)

Requirements: Klipper firmware with EXCLUDE_OBJECT_DEFINE support. OrcaSlicer recommended. STL files must be in the same folder, named to match the EXCLUDE_OBJECT_DEFINE NAME= entries in the G-code.

---

GCodeZAA (original)

UPDATES:

Thanks to the coverage by CNC Kitchen this idea has been getting a lot more attention.

• @mnott has started a Pull Request to OrcaSlicer the pull request was taken over by @adob and is being welcomed by @SoftFever, builds are already available.
• @adob has implemented ZAA directly into BambuStudio
• As it turns out I'm not the first one to come up with this idea

This is a post-processing script to enable smooth(-ish) non-planar top surfaces through a process I've come to call "Z Anti-Aliasing", to differentiate it from true non-planar top surfaces. Maybe "Surface Layer Contouring" would be a better name.

This script is not super user friendly, but should be fine as a proof-of-concept to hopefully get this implemented in slicers directly.

Features

• Close to zero extra printing time cost
• Works on any model
• Works on any surface (not just the top most like many other projects)
• Sub-layer z-details. You can finally add surface textures in your 3d editor!
• Greatly improved surface finish of shallow angle surfaces
• Supports most of the slicer features

Limitations

• Only works in OrcaSlicer
• Non-planar extrusion flow is not great and needs further testing
• Overlapping/double extrusion (this might be solveable by using ironing lines)
• Random artifacts in walls (this might be solveable by using ironing lines)
• Only STLs are supported
• Requres inner/outer wall order
• Only Klipper is supported (marlin could be done with some more work)
• Layer height is less flexible towards coarse heights

Todo

• Ironing support
• Smooth flow transition
• Flow normalization (right now speed is kept constant)
• Travel moves!
• Overhang z contouring
• Integrate properly into OrcaSlicer
• Arc (G2/G3) support

CLI Usage

Orca Slicer + Klipper

1. Slice normally
2. Create a new directory for the plate models
3. For each object on the plate, right click and select "Export as one STL..." and save it as the exact object name to the directory
4. Export the gcode file
5. Run the script as python gcodezaa [path to gcode] -o [path to output] -m [path to the stl directory]

You can use PrusaSlicer to preview the generated GCode, though line height and width will not be displayed properly.

Bambu Studio

Disable Arc fitting

1. Note down the x and y position of your object
2. Slice normally
3. Create a new directory for the plate model
4. Add the following to the post-processing script

python path/to/gcodezaa -m path/to/models -n object_name.stl -p x,y;

Results