Command Line Usage - calh/BambuStudio GitHub Wiki

Command manual

Usage: bambu-studio [ OPTIONS ] [ file.3mf/file.stl ... ]

OPTIONS:

  • --debug level
      Sets debug logging level. 0:fatal, 1:error, 2:warning, 3:info, 4:debug, 5:trace
  • --load-filaments "filament1.json;filament2.json;..."
      Load filament settings from the specified file list, the filament setting count should not exceed the filaments used in the 3mf.
  • --load-settings "machine.json;process.json"
      Load machine/process settings from the specified file, up to 1 machine setting and 1 process setting supported.
  • --outputdir dir
      Output directory for the exported files.
  • --arrange option
      Arrange options: 0-disable, 1-enable, others-auto
  • --orient
      Orient the model
  • --scale factor
      Scale the model by a float factor
  • --export-3mf filename.3mf
      Export project as 3MF.
  • --export-settings settings.json
      Export settings to a file.
  • --export-slicedata slicing_data_directory
      Export slicing data to a folder.
  • --help, -h
      Show command help.
  • --info
      Output the model's information.
  • --load-slicedata slicing_data_directory
      Load cached slicing data from directory
  • --pipe pipename
      Send progress to pipe.
  • --slice plate_index
      Slice the plates: 0-all plates, i-plate i, others-invalid
  • --uptodate
      Update the configs values of 3mf to latest automatically.

There are three ways to input settings:

  1. setting values from the command line (highest priority)
    --key=value, for example: --curr-bed-type="Cool Plate"
  2. setting values loaded with --load_settings and --load_filaments
  3. setting values loaded from 3mf(lowest priority)

The most common usage for slicing

there are three most commonly used cases for slicing:

Use case Detailed description Command Comments
Slice 3mf directly Using the printer/filament/print settings included in the 3mf ./bambu-studio --slice 0 --debug 2 --export-3mf output.3mf test_data/moon.3mf Slicing all the plates in moon.3mf, export the result to output.3mf
Slice 3mf with specific settings Using the printer/filament/print settings included in command line ./bambu-studio --curr-bed-type "Cool Plate" --load-settings "test_data/machine.json;test_data/process.json" --load-filaments "filament1.json;;filament3.json;filament4;;" --slice 2 --debug 2 --export-3mf output.3mf test_data/moon.3mf Slicing plate 2 in moon.3mf, export the result to output.3mf, using the test_data/machine.json to replace all the printer settings in 3mf, using test_data/process.json to replace all the print settings in 3mf, using filament1.json to replace the filament-1's setting in 3mf, using filament3.json to replace the filament-3's setting in 3mf, using filament4.json to replace the filament-4's setting in 3mf, keep the filament-2/5's setting in 3mf.
Slice stls Using the settings included in command line ./bambu-studio --orient --arrange 1 --load-settings "test_data/machine.json;test_data/process.json" --load-filaments "test_data/filament.json" --slice 2 --debug 2 --export-3mf output.3mf test_data/boat.stl Using test_data/machine.json for printer setting, Using test_data/process.json for print setting, Using test_data/filament.json for filament setting, orient and arrange before slicing