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.
Setup
3 commandsGet 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
Live control
10 commandsTalk 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.
AMS
7 commandsSlot 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
Files
7 commandsPush / 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
Printing
7 commandsUpload + 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.
Diagnostics
4 commandsPre-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"}}'
Camera
5 commandsLive 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.
Cloud (optional)
6 commandsBambu 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.
Daemon
5 commandsLong-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.