bambu-cli

Bambu CLI

Overview

Use bambu-cli to configure, monitor, and control BambuLab printers over MQTT/FTPS/camera, producing exact commands and safe defaults.

Defaults and safety

• Confirm the target printer (profile or IP/serial) and resolve precedence: flags > env > project config > user config.
• Avoid access codes in flags; use --access-code-file or --access-code-stdin only.
• Require confirmation for destructive actions (stop print, delete files, gcode send, calibrate, reboot); use --force/--confirm only when the user explicitly agrees.
• Offer --dry-run when supported to preview actions.
• Choose output format: human by default, --json for structured output, --plain for key=value output.

Quick start

• Configure a profile: bambu-cli config set --printer <name> --ip <ip> --serial <serial> --access-code-file <path> --default
• Status: bambu-cli status
• Watch: bambu-cli watch --interval 5
• Start print: bambu-cli print start <file.3mf|file.gcode> --plate 1
• Pause/resume/stop: bambu-cli print pause|resume|stop
• Camera snapshot: bambu-cli camera snapshot --out snapshot.jpg

Task guidance

Setup & config

• Use config set/list/get/remove to manage profiles.
• Use env vars to avoid flags in scripts: BAMBU_PROFILE, BAMBU_IP, BAMBU_SERIAL, BAMBU_ACCESS_CODE_FILE, BAMBU_TIMEOUT, BAMBU_NO_CAMERA, BAMBU_MQTT_PORT, BAMBU_FTP_PORT, BAMBU_CAMERA_PORT.
• Note config locations: user ~/.config/bambu/config.json, project ./.bambu.json.

Monitoring

• Use status for a one-off snapshot; use watch for periodic updates (--interval, --refresh).
• Use --json/--plain for scripting.

Printing

• Use print start <file> with .3mf or .gcode.
• Use --plate <n|path> to select a plate number or gcode path inside a 3mf.
• Use --no-upload only when the file already exists on the printer; do not use it with .gcode input.
• Control AMS: --no-ams, --ams-mapping "0,1", --skip-objects "1,3".
• Disable flow calibration with --flow-calibration=false if requested.

Files and camera

• Use files list [--dir <path>], files upload <local> [--as <remote>].
• Use files download <remote> --out <path|->; use --force to allow writing binary data to a TTY.
• Use files delete <remote> only with confirmation.
• Use camera snapshot --out <path|->; use --force to allow stdout to a TTY.