OpenSCAD auf der Kommandozeile

Begriffe vorab

• CLI: Command Line Interface, Bedienung per Text im Terminal.
• -o: Option für die Ausgabedatei; die Endung bestimmt das Format.
• -D: Setzt eine Variable vor der Ausführung.
• Parameterset: JSON-Datei mit Werten aus dem Customizer.
• Makefile: Build-Datei, die Exporte automatisiert.

Grundform

Das Modell lässt sich ohne Oberfläche exportieren – ideal für Automatisierung und Serien:

openscad -o ausgabe.stl eingabe.scad

Die Dateiendung der Ausgabe bestimmt das Format: stl, off, amf, 3mf, csg, dxf, svg, png oder pdf. Mit --export-format lässt sich das überschreiben; für STL gibt es asciistl und binstl.

Wichtige Optionen

• -D name=wert definiert Variablen vorab. Zeichenketten brauchen Anführungszeichen, die du vor der Shell schützen musst: -D 'qualitaet="produktion"'.
• -p datei.json und -P Name laden Customizer-Parametersets.
• –imgsize breite,hoehe, –camera, –projection, –autocenter, –viewall, –colorscheme steuern PNG-Ausgaben.
• –render oder –preview wählt den Modus beim Bildexport.
• -d datei.deps erzeugt Makefile-Abhängigkeiten, -m make ruft ein Build-System für fehlende Dateien auf.
• -q unterdrückt Ausgaben außer Fehlern, –version zeigt die Version, -h die Hilfe.

Plattformhinweise

Auf macOS liegt das Programm unter /Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD. Unter Windows empfiehlt die Doku den Wrapper openscad.com für die Kommandozeile.

Serien mit einer Schleife

Mit -D baust du Varianten eines Modells, ohne die Datei zu ändern:

for h in 10 20 30; do
  openscad -o "saeule_$h.stl" -D "hoehe=$h" saeule.scad
done

Das Skript saeule.scad braucht dafür nur eine Variable hoehe, die per -D überschrieben wird. Beim Überschreiben per -D unterbleibt die sonst übliche Warnung über doppelte Zuweisung.

// saeule.scad – Variable "hoehe" lässt sich per -D überschreiben
hoehe = 20;
cylinder(h = hoehe, r = 5, $fn = 48);
echo(version = version());

Aufruf: openscad -o saeule.stl -D hoehe=35 saeule.scad. Die Variable aus der Kommandozeile hat Vorrang vor der Zuweisung im Skript.

Alles, was du im Programm klickst, lässt sich auch skripten – nutze die Kommandozeile für Serienexporte und Automatisierung.

Zum Selbermachen

1. Exportiere ein Modell per Kommandozeile als STL und PNG.
2. Erzeuge drei Varianten mit -D und einer Shell-Schleife.

Verwandte Themen

OpenSCAD → Die übrigen Lektionen dieser Themenwelt; Informatik: Grundlagen → „Algorithmen und Berechenbarkeit“ für das Denken in Schritten.

Prüfstatus: Belegt (Stand 1. Oktober 2026): Grundsyntax, Formatwahl über die Endung, –export-format, -D inkl. Quoting, -p/-P, Bildoptionen, -d/-m, -q, –version, -h sowie die Pfadhinweise für macOS und Windows wurden gegen die Seite „Using OpenSCAD in a command line environment“ geprüft. Alle Codebeispiele dieser Lektion wurden mit OpenSCAD 2026.09.18 (lokale Installation) ausgeführt und liefen ohne Fehler und Warnungen. Nicht einzeln belegt: die Shell-Schleife (konstruiert, in der Bash lauffähig, hier nur das Skript getestet) und die Aussage zur Warnungsunterdrückung bei -D (der Hinweis steht auf der Seite „General“). Außerdem nicht einzeln belegt: die Erklärungen in eigenen Worten, die Beispiele als solche (konstruiert) und die Wertungen.

Quellen

• OpenSCAD User Manual – Using OpenSCAD in a command line environment (en.wikibooks.org/wiki/OpenSCAD_User_Manual/Using_OpenSCAD_in_a_command_line_environment)
• OpenSCAD User Manual – General (en.wikibooks.org/wiki/OpenSCAD_User_Manual/General)
• OpenSCAD Cheat Sheet (openscad.org/cheatsheet, bezieht sich auf Version 2021.01)