Was ist eine .gcode-Datei? Inhalt und warum sie druckerspezifisch ist

Ein Befehl pro Zeile

Jede Zeile ist eine Anweisung aus „Wörtern“: einem Buchstaben und einer Zahl. G1 X10 Y-5 F2400 heißt „fahre geradlinig nach X 10, Y −5 mit 2.400 mm/min“. G startet eine Bewegung, M andere Befehle (Temperaturen, den Lüfter), T einen Werkzeugwechsel. X, Y und Z sind die Achsen, E das extrudierte Material, F die Geschwindigkeit, S eine Temperatur oder Spindeldrehzahl. Alles nach einem Semikolon ist ein Kommentar.

Das ist der Anfang einer Schicht aus einer echten Datei, einem 3DBenchy aus PrusaSlicer 2.9.5:

;LAYER_CHANGE
;Z:0.6
;HEIGHT:0.2
;BEFORE_LAYER_CHANGE
G92 E0.0
;0.6
G1 E-.7 F2700
G1 X135.159 Y110.836 Z.4 F21000
G1 X136.128 Y110.075 Z.6 F4491.905
;AFTER_LAYER_CHANGE
;0.6
G1 X136.128 Y110.075 F21000
G1 Z.6 F720
G1 E.7 F1500

Die Düse zieht das Filament zurück (E-.7), fährt schnell und steigt dabei auf die neue Schicht bei 0,6 mm, und schiebt das Filament wieder vor (E.7).

G-Code stammt von Werkzeugmaschinen. In den USA wurde er durch die Norm RS-274 festgelegt, deren letzte Revision, RS-274-D, von 1979 stammt, international durch ISO 6983. In den 3D-Druck kam er über das RepRap-Projekt. Für 3D-Drucker gibt es allerdings keinen gemeinsamen Standard: Jede Firmware – Marlin, Klipper, RepRapFirmware, die von Prusa – hat ihre eigenen Befehle und ihre eigenen Erweiterungen.

Neben .gcode werden auch die Endungen .gco und .g verwendet. Klipper listet alle drei von seiner virtuellen SD-Karte auf, und Marlin ebenso: Es zeigt jede Datei, deren 8.3-Endung mit G beginnt.

Was der Slicer in die Datei schreibt

Dem Drucker würden die Befehle allein reichen. Der Slicer fügt aber Kommentare hinzu, die dir fast alles über den Druck verraten. Der Anfang derselben Datei:

; generated by PrusaSlicer 2.9.5 on 2026-07-03 at 11:30:45 UTC
; printer_model = COREONE
; filament_type = PC
; nozzle_diameter = 0.4
; layer_height = 0.2
; temperature = 285
; filament used [mm] = 5786.33
; filament used [g] = 16.98
; filament cost = 1.27
; estimated printing time (normal mode) = 1h 4m 39s
; estimated printing time (silent mode) = 1h 10m 11s

Darüber hinaus enthält die Datei:

• Vorschaubilder, als Text kodiert (base64) zwischen Zeilen wie ; thumbnail begin und ; thumbnail end. Diese Datei hat vier: drei QOI-Bilder für das Display des Druckers (16 × 16, 313 × 173 und 480 × 240 Pixel) und ein PNG mit 380 × 285 Pixeln für Computer.
• Den Typ jedes Wegabschnitts. Vor jedem steht eine Zeile wie ;TYPE:External perimeter oder ;TYPE:Internal infill. Der Benchy hat 772 davon für den äußeren Perimeter und 163 für das innere Infill. Viewer färben den Weg danach ein.
• Schichtgrenzen: ;LAYER_CHANGE, ;Z: und ;HEIGHT:. Der Benchy hat 240 Schichten.
• Die vollständigen Slicer-Einstellungen am Ende der Datei, zwischen ; prusaslicer_config = begin und = end. Hier sind das 373 Zeilen.
• Den Druckfortschritt für das Display: Zeilen wie M73 P0 R64 sagen, wie viel Prozent fertig sind und wie viele Minuten bleiben; Q und S tun dasselbe für den leisen Modus.

Allerdings schreibt jeder Slicer seine Kommentare auf seine Art. PrusaSlicer markiert den Typ eines Wegs mit ;TYPE:External perimeter, Cura mit ;TYPE:WALL-OUTER, Bambu Studio und OrcaSlicer mit ; FEATURE:. Ein Viewer, der die Markierungen eines anderen Slicers nicht kennt, kann diesen Teil des Wegs nicht einfärben.

All diese Kommentare machen G-Code groß. Der Benchy hat 180.291 Zeilen und 4,5 MB, davon 142.090 G1-Bewegungen. Derselbe Druck als binäre .bgcode gespeichert hat 1,76 MB.

Warum G-Code nur zu einem Drucker passt

G-Code wird für einen Drucker gesliced: für seine Bettgröße, seinen Düsendurchmesser, seine Firmware und seine Startsequenz. Schon der Bericht des NIST von 2000 warnte, dass ein Programm für eine Maschine wahrscheinlich nicht auf der eines anderen Herstellers läuft. Bei 3D-Druckern ist es genauso.

Prusa-Drucker prüfen das selbst. Der Benchy beginnt mit diesen Zeilen:

M862.1 P0.4 A1 F0
M862.3 P "COREONE"
M862.5 P2
M115 U6.5.3+12780

M862.1 prüft den Düsendurchmesser, M862.3 das Druckermodell und M862.5 das G-Code-Level. M115 U vergleicht die Firmwareversion: Ist die Firmware älter, pausiert der Drucker laut der Dokumentation von Prusa 30 Sekunden lang und bittet dich, sie zu aktualisieren. Passt das Modell nicht, warnt der Drucker, der G-Code sei für einen anderen Druckertyp gesliced worden – und im Prusa-Forum fragen Leute, ob es sicher ist, trotzdem weiterzumachen.

Der sichere Weg ist immer derselbe: Slice das Modell noch einmal für deinen eigenen Drucker. Fertigen G-Code weiterzugeben ergibt nur zwischen identischen Druckern mit derselben Düse Sinn.

Im Slicer wählst du den G-Code-Typ (englisch G-code flavor). PrusaSlicer bietet mehr als zehn an, von Marlin 2 über Klipper bis RepRapFirmware. Wenn Bambu Studio eine geslicte Platte exportiert, speichert es ein .gcode.3mf-Paket mit dem G-Code jeder Platte darin.

Lässt sich G-Code wieder in ein Modell verwandeln?

Nein. G-Code trägt den Weg der Düse, nicht die Form. Seiten, die eine Umwandlung von G-Code in STL anbieten, bauen aus den Wegen ein ungefähres Volumen, Stützen und Infill eingeschlossen. Das ist nicht das ursprüngliche Modell, und glatte Formen kommen aus Schichten von 0,2 mm nicht zurück. Brauchst du das Modell, bitte die Person, die es entworfen hat, um das STL, 3MF oder STEP.

So siehst du in G-Code auf Mac, iPad und iPhone

macOS hat keinen Dateityp für G-Code. TextEdit öffnet ihn als Text, und der Finder zeigt ein leeres Symbol – keine Vorschau, keine Miniatur. Unter Windows erledigen das die PowerToys; auf dem Mac brauchst du eine App:

• PrusaSlicer G-code Viewer ist kostenlos und liest G-Code aus PrusaSlicer, Cura, Simplify3D und anderen Slicern.
• Web-Viewer wie gcode.ws zeigen den Weg Schicht für Schicht direkt im Browser. gcode.ws sagt von sich selbst, es sei „langsam, speicherhungrig“.
• ThumbHost3mf ergänzt Miniaturen im Finder aus der Vorschau, die der Slicer in die Datei gespeichert hat.
• Preview3D, meine App, öffnet G-Code in ihrem Fenster, in Quick Look und als Miniatur im Finder, auf Mac, iPad, iPhone und Apple Vision Pro.

Was Preview3D aus G-Code zeigt:

• den Weg nach Typ eingefärbt, mit Legende, so wie der Slicer ihn zeichnet,
• Extrusionen in ihrer echten Breite,
• einen Schichtregler, mit dem du den Druck auf jeder Höhe öffnest,
• Druckzeit, Filament, Gewicht und Material aus dem Header,
• als Miniatur im Finder die Vorschau, die der Slicer in die Datei gespeichert hat.

Es liest G-Code aus PrusaSlicer, SuperSlicer, OrcaSlicer, Cura und Bambu Studio.

Mehr dazu, wofür eine G-Code-Vorschau gut ist: G-Code am Mac ansehen, ohne den Slicer zu starten.

Häufige Fragen

Funktioniert G-Code auf jedem 3D-Drucker?

Nein. Er ist für einen bestimmten Drucker, eine bestimmte Düse und Firmware gesliced. Auf einem anderen Drucker druckt er womöglich neben das Bett, mit falscher Temperatur oder startet gar nicht.

Was ist der Unterschied zwischen .gcode, .gco und .g?

Keiner – es ist dasselbe Textformat mit unterschiedlichen Endungen.

Wo in einer G-Code-Datei stehen Druckzeit und Filamentverbrauch?

In den Kommentaren am Anfang oder Ende der Datei. PrusaSlicer schreibt ; estimated printing time (normal mode) und ; filament used [g]; Cura und Bambu Studio schreiben ähnliche Zeilen in ihrem eigenen Format.

Kann ich G-Code bearbeiten?

In einem Texteditor ja, aber einen Druck von Hand zu bearbeiten ist riskant. Ändere Temperatur, Schichthöhe oder Material im Slicer und slice das Modell neu.

Lässt sich G-Code in STL umwandeln?

Nicht in das ursprüngliche Modell. Du kannst aus den Wegen nur ein ungefähres Volumen bauen, Stützen und Infill eingeschlossen.

Was ist der Unterschied zwischen .gcode und .bgcode?

Sie enthalten dieselben Befehle; .bgcode ist binär und komprimiert. Die Einzelheiten stehen auf der Seite zu .bgcode.

Verwandte Seiten

• Die .bgcode-Datei – binärer G-Code aus PrusaSlicer
• Die .3mf-Datei – das Projekt, aus dem der Slicer G-Code macht, und das Paket .gcode.3mf
• G-Code am Mac ansehen, ohne den Slicer zu starten

Quellen

• RepRap-Wiki: G-code – Syntax der Befehle, Kommentare, Endungen
• NIST: The NIST RS274NGC Interpreter, Version 3 – Herkunft aus der CNC-Technik, RS-274-D
• Marlin: G-code und Klipper: G-Codes
• Prusa Knowledge Base: G-Code-Befehle speziell für die Prusa-Firmware – M862, M115, M73
• Prusa Knowledge Base: PrusaSlicer G-code Viewer
• PrusaSlicer: Vorschaubilder im G-Code und Markierungen der Wegtypen
• CuraEngine: G-Code-Export und OrcaSlicer: Markierungen der Wegtypen
• Klipper: Endungen auf der virtuellen SD-Karte und Marlin: Dateien auf der SD-Karte auflisten

Bei welchem Slicer hat Preview3D den G-Code falsch eingefärbt? Schick ihn mir an apps@xfanta.com, und ich ergänze die Markierungen, die es noch nicht kennt.