A Home Assistant Integration for Bambu Lab printers.
Want to contribute to ha-bambulab? Great! We have a few small asks though!
- Please do not fork and PR against the
mainbranch. - Use the
developbranch, this is our working area. Anything in themainbranch should be considered live, released code. - Please name your commits accordingly, and add some context as to what you have added.
If you feel this integration was valuable and want to support it in other ways, you can buy me a coffee.
To install this integration, add this GitHub Repo to the HACS Custom Repositories, or click the badge above.
For configuration, you'll ideally use your Bambu Credentials for the simplest setup. You can then optionally provide the printers local IP address to enable local direct to printer connection and to enable the P1/A1 camera support.
However, the Bambu cloud connection doesn't support 2FA and passwordless social media accounts at this time. And it obviously does not support printers explicitly set to Lan Only Mode. If you fall into any of these, select the Lan Mode Configuration connection option. You will need to provide:
- Printer Serial Number - can be found in the printer settings or in Bambu Studio.
- Local printer IP address - can be found in the printer network settings (LAN).
- Access Code - can be found in the Printer settings.
If you signed up using any OAuth method, you need to set a password for your Bambu Cloud account:
- Login to the Bambu mobile app using OAuth.
- Tap the person icon at the bottom right.
- Tap Account Security > Change Password.
This will allow you to set a password. Now you can login to the HA integration using your Bambu username and password instead of OAuth.
| Sensor | Notes |
|---|---|
| Aux | |
| Chamber | Not on A1/A1 Mini |
| Cooling |
| Sensor | Notes |
|---|---|
| Bed | |
| Target Bed | |
| Chamber | X1 only |
| Nozzle | |
| Target Nozzle |
| Sensor | Notes |
|---|---|
| Current Layer | |
| Total Layer Count | |
| Print Progress | |
| Print Weight | |
| Print Length | |
| Print Bed Type | Bed choice in the print job |
| Start Time | Simulated on P1/A1 |
| Remainining Time | |
| End Time |
| Sensor | Notes |
|---|---|
| Current Stage | |
| Print Status | |
| Cover Image | |
| Print Weight |
| Sensor | Notes |
|---|---|
| Speed Profile | |
| Timelapse Active |
| Sensor | Notes |
|---|---|
| Active tray | If AMS present |
| Active tray index | If AMS present |
| Lights | Notes |
|---|---|
| Chamber Light | |
| Pause | |
| Resume | |
| Stop | |
| Manual Refresh Mode | P1/A1 only and only available in local MQTT mode |
| Sensor | Notes |
|---|---|
| Humidity Index | |
| Temperature | X1 only |
| Tray 1 | |
| Tray 2 | |
| Tray 3 | |
| Tray 4 | |
| Tray attributes: | |
| Color | |
| Empty | |
| K Value | P1/A1 only |
| Max Nozzle Temp | |
| Min Nozzle TEmp | |
| Name | |
| Type |
| Sensor | Notes |
|---|---|
| External Spool | |
| Tray attributes: | |
| Color | |
| Empty | |
| K Value | P1/A1 only |
| Max Nozzle Temp | |
| Min Nozzle TEmp | |
| Name | |
| Type |
| Sensor | Notes |
|---|---|
| Firmware Update Available | |
| Force Refresh | |
| HMS Errors | Attributes contain the error codes, descriptions and wiki URLs |
| MQTT connection mode | Bambu Cloud or Local |
| Online | |
| Wifi Signal |
| Sensor | Notes |
|---|---|
| Chamber | P1/A1 need the host IP providing |
This integration implements a handful of device triggers to make some common automation scenarios a little easier. See device triggers.
Support for adding LED chamber lights via the WLED project.
- Requires the WLED Home Assistant Integration and the requisite LED lights and ESP device.
- Clink the link below to import the WLED blueprint
- LED lights automatically turn off when Bambu Lida is in use, so as to not interfere.
- LED lights turn red when there is an error in the printer.
- LED lights turn blue when the bed is auto leveling.
- LED lights turn green when printing is finished.
You can find an amazing web configurator to easily create a Dashboard for your Bambu printer like the one below at https://www.wolfwithsword.com/bambulab-home-assistant-dashboard/.
If you run into any issues, we now have built in diagnostics.
To grab the latest information, hit the "Force Refresh Data" button under the Diagnostic section.
Then on the device info page for the printer entity, you will see a "Download Diagnostics" button. Make sure you upload this to your Bug ticket/GitHub issue.
When logging a bug, always ensure you send us the debug logs. These can be enabled from the Integration page itself. The debug logs will appear in the standard Home Assistant logs.
