03 · Command index

54 subcommands.

Each verb is also importable under beambam.. Every command accepts --ip / --code / --serial / --printer NAME to override the default printer section.

01

Setup

3 commands

Get a fresh install to "working" in one command.

beambam init v1.2
Interactive first-run wizard (discover → code → test → write).
beambam init --name studio
beambam find v1.2
SSDP LAN discovery.
beambam find --timeout 5
beambam config v1.2
Credentials editor (list / show / add / remove / rename).
beambam config list --reveal
02

Live control

10 commands

Talk to the printer over signed MQTT.

beambam status
Pull live printer state.
beambam pause
Pause the current print.
beambam resume
Resume a paused print.
beambam stop
Abort current print (cannot resume).
beambam gcode
Send a raw G-code line.
beambam gcode "G28 Z"
beambam set-temp
Set heater target.
beambam set-temp bed 60
beambam led v1.3
Toggle chamber LED. Alias: chamber-light.
beambam jog
Manual XYZ axis jog.
beambam home
Home axes.
beambam level
Auto bed-level.
03

AMS

7 commands

Slot inspection + filament control.

beambam ams status v1.2
Pretty AMS state — colors, humidity, slots.
beambam ams info N v1.2
Detail for one tray by global slot 0..15.
beambam ams load N
Load filament from slot N.
beambam ams unload
Unload current filament.
beambam ams dry v1.2
Start a drying cycle on an AMS unit.
beambam ams dry 0 --temp 55 --hours 8
beambam ams set N P v1.3
Push tray_info_idx + temps + color from a flat profile.
beambam ams set 7 './eSUN PLA+.json' --color F98C36
beambam ams sync v1.3
Batch-push every slot from flat-profiles/ams-sync.json.
beambam ams sync --dry-run
04

Files

7 commands

Push / pull / list / slice / analyze.

beambam push v1.3
Push .gcode.3mf to printer SD via FTPS. Alias: upload.
beambam pull v1.3
Pull a file off the printer SD via FTPS. Alias: download.
beambam pull '/cache/x.3mf'
beambam files
List printer SD contents.
beambam fetch
Download from MakerWorld / direct URL.
beambam slice v1.2
Standalone STL slice via BambuStudio CLI.
beambam slice model.stl -o out.gcode.3mf
beambam analyze v1.2
Dissect a local .gcode.3mf — flushes, AMS, hints.
beambam analyze model.gcode.3mf
beambam frame v1.2
Generate a picture-frame STL with debossed text.
beambam frame --preset rumi -o rumi.stl
05

Printing

7 commands

Upload + start, or queue for later.

beambam print
Upload + start print with AMS mapping.
beambam print model.3mf --slot 5
beambam slice-print
Slice + upload + start in one shot.
beambam simulate
Dry-run the signed MQTT payload (no publish).
beambam queue list v1.2
Show pending jobs.
beambam queue add v1.2
Enqueue a .gcode.3mf.
beambam queue rm v1.2
Delete a job.
beambam queue clear v1.2
Remove all jobs.
06

Diagnostics

4 commands

Pre-print sanity + debugging.

beambam doctor v1.2
Full health check — AMS, HMS, sensors, wifi.
beambam health
Connectivity + MQTT smoke test.
beambam mqtt sub v1.2
Stream the printer reply topic.
beambam mqtt pub v1.2
Sign + publish arbitrary JSON.
beambam mqtt pub '{"print":{"command":"pause"}}'
07

Camera

5 commands

Live view + snapshots.

beambam cam v1.3
One-shot snapshot save (bare verb).
beambam cam watch v1.2
Live terminal viewer (kitty / iTerm2 / blocks).
beambam cam start v1.3
Background RTSP→MJPEG proxy. Alias: camera.
beambam cam stop v1.3
Kill the running proxy via ~/.x2d/cam.pid.
beambam webrtc
WebRTC gateway for browser viewing.
08

Cloud (optional)

6 commands

Bambu Cloud + MakerWorld queries.

beambam cloud-login
Auth to Bambu Cloud.
beambam cloud-status
Check current session.
beambam whoami v1.2
Logged-in user identity.
beambam history v1.2
Recent cloud print history.
beambam cloud-fetch --info v1.2
MakerWorld design metadata.
beambam cloud-fetch --info 1501027
beambam cloud-print
Cloud-side print start.
09

Daemon

5 commands

Long-running services.

beambam boo v1.3
HTTP + SSE + Prometheus + HA + queue. Alias: daemon.
beambam boo --http :8765 --queue --timelapse
beambam serve
Unix-socket RPC for libbambu_networking.so.
beambam ha v1.3
One-shot HA MQTT discovery push. Alias: ha-publish.
beambam watch
Tail state updates.
beambam timelapse
Start/stop on-printer timelapse.

Full per-command help: beambam <cmd> --help. Deep-dive docs: /docs. v1.2 tag marks commands new in the current release.