Printago
🎉 WIN a Snapmaker U1 Printer! Enter FREE now

Bambu Studio CLI Reference

Bambu Lab's official slicer featuring project-based workflows, systematically optimized slicing algorithms, and an incredibly smooth printing experience.

55 flags v2.8.0 bambu-studio

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.

bambu-studio \
  --slice 1 \
  --load-settings "machine.json;process.json" \
  --load-filaments "filament.json" \
  --export-3mf out.gcode.3mf \
  model.3mf

Every flag, by category

All 55 command-line flags, grouped by what they do. Each links to its full reference.

Input & Configuration 13

--load-settings Load process & machine settings. Machine first, then process. --load-filaments Load filament settings, one file per slot. --load-filament-ids Map objects to filament slots by index. --load-assemble-list Build multi-object plates without a project 3MF. --load-custom-gcodes Load custom G-code tool-change events from JSON. --load-slicedata Load cached slice data to avoid re-slicing. --allow-newer-file Allow slicing a 3MF made by a newer Bambu Studio version. 1.9.7--allow-mix-temp Allow filaments with incompatible temperatures together. 2.0.0--skip-modified-gcodes Skip modified G-code from printer/filament presets. --load-defaultfila Load the first filament as the default for unassigned objects. --uptodate Update config values in the 3MF to the latest. --uptodate-settings Updated machine/process settings for --uptodate. --uptodate-filaments Updated filament settings for --uptodate.

Slicing Actions 8

--slice Slice the plates. 0 = all, i = plate i. --no-check Skip validity checks including G-code path conflicts. --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 slicing job as using timelapse. --normative-check Run normative compliance checks on the output. --estimate-mode Fill filament/extruder state for estimation after a machine switch. 2.7.1

Object Arrangement & Transformation 14

--arrange Auto-arrange: 0 disable, 1 enable, other = auto. --allow-rotations Allow object rotation during arrange. --allow-multicolor-oneplate Allow multiple colors on one plate during arrange. --avoid-extrusion-cali-region Avoid the extrusion calibration region when placing. --assemble Arrange models and merge them into a single model. --ensure-on-bed Lift objects sitting partially below the bed. --orient Auto-orient: 0 disable, 1 enable, other = auto. --rotate Rotate around the Z axis. --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 10

--export-3mf Export the sliced project as a .gcode.3mf. --export-slicedata Export slice data for reuse with --load-slicedata. --export-settings Export current settings to JSON. --export-png Export a PNG of a plate. 0 = all, i = plate i. 2.1.0--camera-view Camera angle for the exported PNG (Iso, Top_Front, …). 2.1.0--export-stl Export objects as a single merged STL. --export-stls Export objects as multiple individual STLs. 1.9.7--outputdir Output directory for exported files. --min-save Export the 3MF at minimum file size. --skip-useless-pick Skip unused pick/top thumbnails. Faster headless slicing.

Progress & Debugging 4

--pipe Stream slicing progress as JSON to a named pipe. --debug Log level, 0 (fatal) to 5 (trace). --info Print model information without slicing. --help Show the help / usage text.

Metadata Embedding 4

--metadata-name Metadata keys to embed in the output 3MF. 1.9.7--metadata-value Metadata values matching --metadata-name. 1.9.7--makerlab-name MakerLab name to embed in the 3MF. --makerlab-version MakerLab version to embed in the 3MF.

Downward Compatibility 2

--downward-check Check downward compatibility with a machine list. 1.9.7--downward-settings Machine settings list for downward checks. 1.9.7

CLI changes between versions

Bambu Studio’s CLI surface evolves quietly between releases. What changed, newest first.

2.8.0
No CLI flag changes.
2.7.1
  • Added --estimate-mode — fill filament/extruder state for estimation after a machine switch.
2.1.0
  • Added --export-png and --camera-view — render a plate to a PNG at a chosen angle.
2.0.0
  • Added --allow-mix-temp — print incompatible-temperature filaments together.
1.9.7
  • Added --allow-newer-file, --export-stls, --metadata-name, --metadata-value, --downward-check, --downward-settings.
1.8.4
Baseline for this reference.

Frequently asked questions

See also

Bambu Studio CLI deep-dive The long-form guide with patterns and gotchas.Orca Slicer CLI The same CLI on the community fork.

Sign up for free today

No credit card required. Connect unlimited printers and get production automation running in minutes.

Get started