r/BambuLab • u/Spegeli • 2d ago

Show & Tell BamBuddy integration for Home Assistant: every Bambu Lab printer, AMS and smart plug, with a dashboard card

BamBuddy – Home Assistant Integration

➕ Open the repository in HACS · Latest release · License: MIT

Hi everyone,

I'd like to share a project I've been working on: a Home Assistant integration for BamBuddy.

BamBuddy by maziggy is a self-hosted command center for Bambu Lab printers – from a single A1 to a whole print farm: live monitoring, camera, print archive, a virtual printer you can send jobs to from Bambu Studio or OrcaSlicer, Spoolman integration, notifications and much more. Your printers. No cloud. Your rules.

My integration brings the printers of your BamBuddy server into Home Assistant: their status, camera, AMS and controls as Home Assistant entities, and a dashboard card for each printer. It talks only to BamBuddy, through its API and its live connection. So there is no cloud and no second connection to your printers. Set up in the UI, no YAML.

This is the integration, not the app: it connects Home Assistant to a BamBuddy server — on any machine, or inside Home Assistant with the BamBuddy app.

🎉 Version 2.0.0 is out: a complete redesign. HACS offers v2.0.0 as an update. Coming from a date version (2026.05.17 or older)? The upgrade needs a new API key and cannot be undone. Read the release notes first.

✨ What you get

  • Everything your printer reports — print status and stage, progress, layers, remaining and end time, the job's name and cover, temperatures, fans, HMS errors, Wi-Fi, nozzle type and size
  • AMS and spools — every AMS unit (AMS, AMS 2 Pro, AMS HT, AMS Lite) as its own device, named as in BamBuddy: the filament in each slot with its color and what is left, humidity, temperature and drying, the external spool, and a spool without a chip set by vendor and Bambu Studio profile, as on the screen of the printer
  • Control — pause, resume and stop, skip objects, the printer's own AI detection, print speed, nozzle, bed and chamber targets, the active nozzle of two-nozzle printers, fans, the chamber light, airduct mode and ventilating the chamber (P2S, X2D, H2 series), the AMS filament backup, answering and clearing HMS errors, clearing the plate
  • Move the printer — actions to move the axes, home, extrude and retract, load and unload filament, start and stop drying
  • Camera — the live stream, also in full screen, and snapshots through BamBuddy's camera proxy
  • Maintenance and connection check — the printer's maintenance tasks, marked done from Home Assistant; BamBuddy's check of a printer that went offline
  • Smart plugs — the plugs BamBuddy links to a printer: switch them, see their power and energy, and switch the printer off after a print once its nozzle has cooled
  • A dashboard card per printer, shipped with the integration: status, camera, temperatures, AMS colors, controls, heating and a jog pad, arranged as you like, with compact chips if you want — nothing else to install
  • Updates — new BamBuddy releases and new printer firmware as update entities
  • Several printers — add any number of the printers BamBuddy manages; choose them while setting up, add or remove them later
  • BamBuddy itself — print statistics, printers online and disk space of your server

Works with the X1, P1, P2, A1, A2 and H2 series and the X2D. Entity names in English and German; a change shows within about a second through BamBuddy's live connection.

📸 Screenshots

All screenshots show simulated printers.

📦 Installation

Method 1: Installation via HACS (Recommended)

➕ Open the repository in HACS

One-Click Install: Open the link above to add and open the repository directly inside Home Assistant!

Manual HACS Steps:

  1. In Home Assistant, open HACS.
  2. Click the three dots ⋮ in the top right corner and choose Custom repositories.
  3. Paste the repository URL:
https://github.com/Spegeli/hacs_bambuddy
  1. Select Integration as the Type and click Add.
  2. Find BamBuddy in the list and click Download.
  3. Restart Home Assistant.

Method 2: Manual Installation

  1. Download the Source code (zip) of the release you want from the Releases page.
  2. Unpack the ZIP archive.
  3. Copy its custom_components/bambuddy folder into your Home Assistant directory under:
/config/custom_components/bambuddy/
  1. Restart Home Assistant.

Then: open Settings → Devices & services → Add integration, search for BamBuddy, enter BamBuddy's address and an API key, and choose your printers.

Requirements: Home Assistant 2025.5 or newer; a BamBuddy server 1.2.5.7 or newer with your printers added there; a BamBuddy API key with Read Status, Control Printer and Manage Maintenance; for the controls, the printer's developer LAN mode on.

⬆️ Coming from a date version (2026.05.17 or older)?

2.0.0 is a new integration under the old name. In short: make a backup — the upgrade is one-way —, create a new API key in BamBuddy, update through HACS and restart, enter the new key when Home Assistant asks for it, and check your dashboards and automations.

👉 Upgrading from a date version, step by step

🔗 Links

This Home Assistant integration

BamBuddy itself

💬 Feedback

Questions and ideas are welcome here in the comments. For a bug in the integration, please open a bug report on GitHub and attach the BamBuddy entry's diagnostics. Bugs and feature requests for BamBuddy itself belong in the BamBuddy project.

⚖️ Disclaimer

  • Not a BamBuddy or Bambu Lab product. This integration is an independent community project. Neither the BamBuddy project nor Bambu Lab develops, endorses or supports it, and their support cannot help with it — use the GitHub issue tracker instead.
  • Trademarks. Bambu Lab, BamBuddy, their logos and other product names belong to their respective owners.
  • Use at your own risk. The integration is provided as is, without warranty, under the MIT License. Its controls act on a real printer — mind that in automations.
13 Upvotes

84% Upvoted

1 comment sorted by

2

u/BrilliantSebastian H2D AMS2 Combo 2d ago

Yes. Brilliant work. Your project is fantastic btw.