GPX(1)

💖 GPX(1) 💖 — like, the manual page for gpx, bestie

User Commands ✨ the gpx page

---

🌸 NAME 🌸

gpx — G-code to X3G converter

yes queen, it takes your G-code and turns it into X3G, that's the whole job description 💅

---

✨ SYNOPSIS ✨

gpx [-CFdgilpqrstvw] [-b BAUDRATE] [-c CONFIG] [-e EEPROM] [-f DIAMETER]
[-m MACHINE] [-N h|t|ht] [-n SCALE] [-x X] [-y Y] [-z Z] IN [OUT]

so the vibe is: a pile of lil flags, some options that take values, then your IN file and optionally an OUT file. iykyk 🦋

---

🎀 OPTIONS 🎀

okay bestie, this is the part where you actually pay attention, no cap 👑

• -C — make a temporary file with a copy of the machine configuration. it's giving "backup but temporary" 🫶
• -C — make a temporary file with a copy of the machine configuration. not me listing this twice… but fr fr the original lists it twice, so here we are. two -Cs. iconic. 💀
• -F — write X3G on-wire framing data to the output file. framing data, slay ✨
• -N h|t|ht — turn off writing the X3G header (the start build notice), the tail (the end build notice), or both. h = header, t = tail, ht = both, periodt 💅
• -d — simulated ditto printing. ditto, but make it simulated 🍓
• -g — Makerbot/ReplicatorG GCODE flavor. a flavor, like a lil ice cream scoop of GCODE 🌈
• -i — enable stdin and stdout support for command line pipes. pipes!! the plumbing of the gods 🧚
• -l — log to file. receipts, but make it a file 📝
• -p — override build percentage. going rogue on the percent 💫
• -q — quiet mode. shhh, main character energy but silent 🙈
• -r — Reprap GCODE flavor. another flavor bestie, pick your fighter 🍧
• -s — enable USB serial I/O and send x3G output to the 3D printer. we're going STRAIGHT to the printer, no middleman 🔥
• -t — truncate the filename (DOS 8.3 format). 8.3 format, ancient and yet still here, we love a survivor 👑
• -v — verose mode. yes it says "verose", that's literally what the page says, I'm not editing it, that's the source's own typo and I respect it 💀
• -w — rewrite 5d extrusion values. 5d, mysterious, gorgeous, no notes 🦋
• -b BAUDRATE — set BAUDRATE for serial I/O. Default is 115200. default noted, bestie, don't come for me 💖
• -c CONFIG — CONFIG is the filename of a custom machine definition (ini file). ini file, your machine's little biography ✨
• -e EEPROM — EEPROM is the filename of an eeprom settings definition (ini file). another ini file, this one for eeprom settings 🎀
• -f DIAMETER — DIAMETER is the actual filament diameter in the printer. measure your filament, bestie, it matters 🌸
• -m MACHINE — MACHINE is the predefined machine type. Available configurations are: the whole lineup, come get your fave 👇
  • c3 = Cupcake Gen3 XYZ, Mk5/6 + Gen4 Extruder
  • c4 = Cupcake Gen4 XYZ, Mk5/6 + Gen4 Extruder
  • cp4 = Cupcake Pololu XYZ, Mk5/6 + Gen4 Extruder
  • cpp = Cupcake Pololu XYZ, Mk5/6 + Pololu Extruder
  • cxy = Core-XY with HBP - single extruder
  • cxysz = Core-XY with HBP - single extruder, slow Z
  • cr1 = Clone R1 Single with HBP
  • cr1d = Clone R1 Dual with HBP
  • r1 = Replicator 1 - single extruder
  • r1d = Replicator 1 - dual extruder
  • r2 = Replicator 2 (default) the default, the moment, the legend ⭐
  • r2h = Replicator 2 with HBP
  • r2x = Replicator 2X
  • t6 = TOM Mk6 - single extruder
  • t7 = TOM Mk7 - single extruder
  • t7d = TOM Mk7 - dual extruder
  • z = ZYYX - single extruder
  • zd = ZYYX - dual extruder
• -n SCALE — SCALE is the coordinate system scale for the conversion (ABS = 1.0035). one point zero zero three five, that's the number, copy it exactly bestie 🔢
• -x X, -y Y, -z Y — the axis offsets:
  • X = the x axis offset
  • Y = the y axis offset
  • Z = the z axis offset

heads up bestie: the option header up there says -x X, -y Y, -z Y and the synopsis says [-z Z]. that's the original's own lil inconsistency, and I'm keeping it character-for-character because the one rule is: the vibe changes, the facts do NOT. 🫶

---

🌈 EXAMPLES 🌈

here's the tea, actual commands, copy them exactly 👇

gpx -p -m r2 my-sliced-model.gcode
gpx -c custom-tom.ini example.gcode /volumes/things/example.x3g
gpx -x 3 -y -3 offset-model.gcode
gpx -m c4 -s sio-example.gcode /dev/tty.usbmodem

• first one: override the build percentage, pick the r2 machine, convert my-sliced-model.gcode. simple, clean, ate ✨
• second one: custom config custom-tom.ini, input example.gcode, output to /volumes/things/example.x3g. giving "I know where my files live" energy 🎀
• third one: offset it, -x 3 and -y -3. note the minus, bestie, don't drop it 🍓
• fourth one: c4 machine, serial I/O on, straight out to /dev/tty.usbmodem. plugged in and sending it 🔥

---

okay that's the whole page, you're literally a gpx expert now, so proud, no notes, go convert something 💖✨

this page came from the gpx source, version dated 2020-12-01, filed under GPX(1) in User Commands — mwah, bye bestie! 💅🦋🌸