Orca Slicer CLI Reference
The community slicer focusing on ultra-fast slicing, intelligent support generation, and seamless printer compatibility.
54 flags v2.4.0 orca-slicer
A typical headless slice
The core of any automated slice: load your settings and filaments, point at a model, and export a G-code-bearing 3MF. Click any flag below for a source-level explanation, examples, and gotchas.
orca-slicer \
--slice 1 \
--load-settings "machine.json;process.json" \
--load-filaments "filament.json" \
--export-3mf out.gcode.3mf \
model.3mfEvery flag, by category
All 54 command-line flags, grouped by what they do. Each links to its full reference.
Input & Configuration 14
--datadir Set the directory Orca loads and stores settings from. --load-settings Load process & machine settings from JSON. Order matters: machine first. --load-filaments Load filament settings, one file per slot. --load-filament-ids Map objects to filament slots by ID. --filament-colour Per-slot filament colors, positionally matched to filaments. --load-defaultfila Load the first filament as the default for objects that don't have one loaded. --load-assemble-list Build multi-object / multi-color plates without a project 3MF. --load-custom-gcodes Load custom G-code (e.g. tool-change) from JSON. --load-slicedata Load cached slice data to avoid re-slicing unchanged inputs. --allow-newer-file Allow slicing a 3MF made by a newer Orca version. --skip-modified-gcodes Ignore modified G-code from printer/filament presets. --uptodate-settings Settings used when refreshing a 3MF with --uptodate. --uptodate-filaments Filament settings used with --uptodate. --uptodate Update config values embedded in the 3MF to the latest.
Slicing Actions 8
--slice Slice the plates. The flag that triggers headless slicing. --no-check Skip validity checks such as G-code path conflict detection. --allow-mix-temp Allow high- and low-temp filaments on the same print. 2.3.2--skip-objects Skip specific objects by index. --mstpp Maximum slicing time per plate, in seconds. --mtcpp Maximum triangle count per plate. --enable-timelapse Mark the job as using timelapse. --normative-check Run normative item checks.
Object Arrangement & Transformation 14
--arrange Auto-arrange objects: 0 disable, 1 enable, other = auto. --allow-rotations Allow rotation when placing objects during arrange. --allow-multicolor-oneplate Allow multiple colors on one plate during arrange. --avoid-extrusion-cali-region Keep objects clear of the extrusion calibration region. --assemble Arrange models and merge them into a single model. --ensure-on-bed Lift objects sitting partially below the bed. --orient Auto-orient objects: 0 disable, 1 enable, other = auto. --rotate Rotate around the Z axis, in degrees. --rotate-x Rotate around the X axis. --rotate-y Rotate around the Y axis. --scale Scale the model by a float factor (1.5 = 150%). --clone-objects Clone objects from the load list. --repetitions Repeat the whole model N times. --convert-unit Convert model units.
Output 7
--export-3mf Export the sliced project as a G-code-bearing 3MF. --export-slicedata Export slice data for reuse with --load-slicedata. --export-settings Export the resolved settings to JSON. --export-stl Export objects as a single merged STL. --export-stls Export objects as individual STLs to a directory. --outputdir Output directory for exported files. --min-save Export the 3MF at minimum file size.
Progress & Debugging 5
Metadata Embedding 4
CLI changes between versions
Orca Slicer’s CLI surface evolves quietly between releases. What changed, newest first.
2.4.0
- Added
--logfile— redirect debug logging to a file.
2.3.2
- Added
--allow-mix-temp— print high- and low-temperature filaments together.
2.3.1
No CLI flag changes.
2.3.0
Baseline for this reference.
Frequently asked questions
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.