Skip to main content

XGML

XGML: eXtensible G-code Markup Language, the lightweight markup language specifically designed for easier prototyping of G-Code, without the complex G commands. Simple tags, no closing tag boilerplate from XML and others (</>).

What does it solve?

It solves having to read clunky G-code, let alone actually... understand it at the same efficiency you would understand XGML. It is also an easy markup language to test 3D-printers, make complex patterns, for people who... just don't have well-established experience with 3D modelling.

Why a Markup Language?

Markup languages are really lightweight, declarative, and serve their simple purposes well.

How to use XGML?

  • Installation

Run:

pip install xgml
  • Transpiling XGML scripts

If cloning from GitHub, just copy the parse/xgmlparse.py file over to your preferred directory.

Run:

xgml FILENAME.xgml
# -- OR --
python3 xgmlparse.py FILENAME.xgml 
# Second option will be applied if you cloned this repository.
# File is found with the same name, with the .gcode extension.

What 3D printers does it support?

I'm a WASP enthusiast. so the coordinate system is exactly like the one in their printers, though it supports any 3D printer that can process standard Marlin G-Code.

** Two things to keep in mind...

• Print bed size might not match up to the scripts coordinates. Double check before loading onto the printer.

• Some printers require complex start codes, e.g. Bambu Lab X1C

Try it out!

Here, I've written some XGML code (also found here at test/layers.xgml)

<module XGML_3D_TEST_PRINT
    <var print_bed_temp: 60.0>
    <var print_noz_temp: 210.0>
    <var circle_radius: 12.5>
    <var total_layers: 4>

    <temperature nozzle:print_noz_temp bed:print_bed_temp end>
    <fan speed:255 end>

    <path @f4000 end>
    <path x:0.0 y:0.0 z:0.3 e:0.0 end>
    <path x:10.0 y:10.0 z:0.3 e:1.25 end>

    <loop @for total_layers @zstep 0.4
        ; This circle will automatically print higher on every single pass
        <polygon @PREDEF CIRCLE r:circle_radius end>
        
        ; A travel and extrusion path inside the layer loop
        <path x:30.0 y:30.0 e:2.5 end>
        
        ; This square will stack right along with the circle
        <polygon @PREDEF SQUARE size:20.0 end>
    end>

    <fan speed:0 end>
    <temperature nozzle:0.0 bed:0.0 end>
end>

License

This project is licensed under the Apache License 2.0. Feel free to use, modify, distribute, and build upon this core engine for both personal and commercial 3D printing workflows! See the source headers and the LICENSE for more details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xgml-10.0.0.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

xgml-10.0.0-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

Details for the file xgml-10.0.0.tar.gz.

File metadata

  • Download URL: xgml-10.0.0.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for xgml-10.0.0.tar.gz
Algorithm Hash digest
SHA256 40c734db11e5e2bba019d52ef2314efbd025fb1f1eda16061d50dc2ca0b3e15f
MD5 f6e4365e7158693050f78f31d8a87a26
BLAKE2b-256 4228fcf0bf3633bfd5c86fc22a6ab9a84e9081125419ee3d3403c33346fd8592

See more details on using hashes here.

File details

Details for the file xgml-10.0.0-py3-none-any.whl.

File metadata

  • Download URL: xgml-10.0.0-py3-none-any.whl
  • Upload date:
  • Size: 9.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for xgml-10.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b4afb52b4874933a70d28a7b948f256e1e512b2001d85479d6feef790492ce06
MD5 90fdf28c2069bf6b51b7b5f5008dd7ac
BLAKE2b-256 eccd711d1ab33bb927d05aa233e6de71293f511dd2206eb2c0dca354043414d5

See more details on using hashes here.

Release history Release notifications | RSS feed

15.0.0

2 files

This release

10.0.0 This release

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page