A Home Assistant integration for Bambu Lab 3D printers. Live print status, temperatures, fans, AMS and external spool filament, chamber camera, print controls, HMS errors, device triggers, MakerWorld stats and a set of built-in dashboard cards. Connects through Bambu Cloud or directly to the printer on your LAN.

_{The bundled dashboard cards, rendered with sample data. Your cards show your printer's real values and print preview.}

Full documentation lives at docs.page/greghesp/ha-bambulab. For questions and help, join us on Discord.

• Supported printers
• How it works
• Features
• Dashboard cards
• Installation
• Configuration
• Bambu Lab firmware and authorization
• Automations
• Actions
• Troubleshooting
• Contributing
• License

AMS units: AMS, AMS Lite, AMS 2 Pro, AMS HT and AMS 3H, plus the external spool holder. Some entities only exist on some models; the entity reference says which.

Bambu Lab printers publish their state over MQTT. The integration subscribes to that feed and pushes updates into Home Assistant as they arrive (local_push), with no polling delay.

Two-factor authentication is supported. Bambu accounts created with Google, Apple or Facebook need a password set first (how).

A short tour. The complete list, with per-model notes, is in the entity reference.

A chamber camera entity on every model. On P1/A1 printers it needs the printer's IP; on X1 enable LAN Mode Liveview; on H2D, H2S, H3C and X2D enable LAN Only Liveview (details).

HMS errors (with codes, descriptions and wiki links), print errors, online state, Wi-Fi signal, SD card status, enclosure door, firmware update available, MQTT connection mode and a Force Refresh button.

Set up with Bambu credentials and your account's MakerWorld profile appears as its own device: points, boosts, downloads, prints, likes, collects, followers and level, refreshed every 15 minutes.

The integration ships its own cards and registers them for you when your dashboards are UI-managed. Edit dashboard → Add card → search "Bambu Lab". Every option is in the visual editor.

A picture of your printer with live values laid over it: progress and time left on the screen, nozzle, bed and chamber temperatures, fans, light, door, humidity and the print preview on the bed. Tap a value to open it.

Light theme	Dark theme

type: custom:ha-bambulab-print_status-card
printer: <printer device id>

The AMS card shows one AMS unit with its humidity and temperature. The active slot is highlighted and animated, and remaining filament shows when it's enabled in the slicer for a Bambu spool. The AMS Graphic card draws the unit itself (AMS, AMS 2 Pro, AMS HT) with fill levels and labels. Tap a spool to see its details or change its filament.

The H3C's AMS 3H uses the AMS card: its nine spools in two rows, and each drying zone's humidity, temperature and drying time left in the info bar (details).

AMS card (vector style)	AMS Graphic card (AMS 2 Pro, dark)

type: custom:ha-bambulab-ams-card
ams: <AMS device id>
style: vector        # or graphic
show_info_bar: true

Spool card (external spool)	Print Control card

• Spool card: one spool, the external spool or a single AMS slot (any of the AMS 3H's nine).
• Print Control card: printing speed plus Pause, Resume and Stop, and skip objects on the plate mid-print.

YAML-mode dashboards: the cards aren't registered automatically, so add the resource yourself:

lovelace:
  mode: yaml
  resources:
    - url: /bambu_lab/ha-bambulab-cards.js
      type: module

Prefer a full pre-built dashboard? WolfWithSword's dashboard configurator generates one (it uses other community cards, not these).

ha-bambulab is in the default HACS store. Click the button, or search for Bambu Lab in HACS, install, then restart Home Assistant.

1. Download bambu_lab.zip from the latest release.
2. Extract it into config/custom_components/bambu_lab/.
3. Restart Home Assistant.

Requires Home Assistant 2025.1.1 or later.

1. Settings → Devices & Services → Add Integration
2. Search for Bambu Lab
3. Pick a connection type and follow the wizard.

Printers on your network are also discovered automatically (SSDP).

Enter your Bambu Lab account e-mail and password (and the 2FA code if asked; if your authenticator code is refused, a code is sent by e-mail or SMS instead). Pick the printer, then optionally add its local IP for a direct connection.

You need, from the printer:

Some entities need an extra printer setting:

• Camera on H2D / H2S / H3C / X2D: enable LAN Only Liveview (LAN mode itself is not required).
• Cover image, print weight and bed type on newer firmware (e.g. H2D, H2S, P2S): enable Store Sent Files on External Storage and insert a USB drive / SD card.

Set a password first: in the Bambu Handy app, tap the person icon → Account Security → Change Password. Then sign in to the integration with your e-mail and that password.

Starting with X1C 01.08.05.00, P1 01.08.02.00 and A1 01.05.00.00, Bambu Lab firmware restricts third-party control.

If you rely on Home Assistant controls and want to stay cloud connected, don't update to these firmware versions. Otherwise put the printer in LAN Mode and enable Developer LAN Mode. More detail in the overview.

The printer device offers device triggers, so common automations are point-and-click: Print started, Print finished, Print canceled, Print failed, Printer error detected (HMS), Print error detected, the matching error cleared triggers and SD card missing.

Behind them is one event, bambu_lab_event. Its data carries the device_id, the printer name and the trigger type, plus code, error and url (wiki link) for errors.

Example: notify with the HMS error text.

automation:
  - alias: "Bambu printer error"
    trigger:
      - platform: event
        event_type: bambu_lab_event
        event_data:
          type: event_printer_error
    action:
      - service: notify.notify
        data:
          title: "Printer error on {{ trigger.event.data.name }}"
          message: "{{ trigger.event.data.code }}: {{ trigger.event.data.error }}"

Example: notify when a print finishes.

automation:
  - alias: "Bambu print finished"
    trigger:
      - platform: event
        event_type: bambu_lab_event
        event_data:
          type: event_print_finished
    action:
      - service: notify.notify
        data:
          message: "{{ trigger.event.data.name }} has finished printing."

More in Device Triggers.

Parameters and examples: Actions.

When reporting an issue, attach diagnostics: on the printer's device page, choose Download diagnostics. Credentials are redacted.

See Issues for debug logging and more.

Want to help? Read the contributing guide and open PRs against main.

If this integration is useful to you, you can buy Adrian a coffee.

This project is licensed under the MIT License.