discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
Spegeli/homeassistant-app-bambuddy · source
Snapshot 0 · 2026-11-04T12:47:28Z · Shell ·
Content fingerprint
50b20dbde147b0b5d4aaed7a3a6e20fbe429f32926f28020e11108e04342f5afGitHub description at capture
BamBuddy – self-hosted Bambu Lab printer management as a Home Assistant App.
README at capture
<p align="center"> <img src="https://github.com/Spegeli/homeassistant-app-bambuddy/blob/main/logo.png?raw=true" alt="BamBuddy Logo" width="300"> </p> <h1 align="center">BamBuddy – Home Assistant App</h1> <p align="center"> <a href="https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https://github.com/Spegeli/homeassistant-app-bambuddy"><img src="https://my.home-assistant.io/badges/supervisor_add_addon_repository.svg" alt="Add Repository to Home Assistant"></a> </p> <p align="center"> <img src="https://img.shields.io/badge/dynamic/yaml?url=https://raw.githubusercontent.com/Spegeli/homeassistant-app-bambuddy/main/bambuddy/config.yaml&query=$.version&label=stable&color=blue"> <img src="https://img.shields.io/badge/dynamic/yaml?url=https://raw.githubusercontent.com/Spegeli/homeassistant-app-bambuddy/main/bambuddy-daily/config.yaml&query=$.version&label=daily&color=purple"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT%20%2B%20AGPL--3.0-yellow" alt="License: MIT + AGPL-3.0"></a> </p> <p align="center"> 💬 Questions and discussion: <a href="https://community.home-assistant.io/t/1026198">Home Assistant forum</a> · <a href="https://www.reddit.com/r/BambuLab/comments/1xinhv3/bambuddy_as_a_home_assistant_app_your_selfhosted/">r/BambuLab on Reddit</a> </p> <p align="center"> <a href="https://github.com/maziggy/bambuddy">BamBuddy</a>, delivered as a first-class Home Assistant App for easy installation and updates. </p> <p align="center"> <strong>Your printers. No cloud. Your rules.</strong><br> Self-hosted command center for Bambu Lab — from one A1 to an entire print farm. </p> <p align="center"> <em>This is the app, not the integration: it runs the BamBuddy server inside Home Assistant. For your printers' status, camera, AMS and controls as Home Assistant entities and a dashboard card, add the <a href="https://github.com/Spegeli/hacs_bambuddy">BamBuddy integration</a> as well.</em> </p> --- ## ✨ Features - **One-click install** — prebuilt images for **amd64 and aarch64**; nothing is built on your device, so it also runs on a Raspberry Pi - **Two channels** — *BamBuddy* (stable, recommended) and *BamBuddy (Daily)* with the latest upstream daily build - **Automatic updates** — new BamBuddy releases are picked up automatically, tested on both architectures before they are published, then shown in Home Assistant as a normal update, release notes included - **Your data stays put** — the print archive, settings and logs live in the app's configuration folder (`addon_configs`); they survive updates and even an uninstall (unless you choose to delete that folder), and they are part of your Home Assistant backups - **Printer discovery and the virtual printer** — work out of the box --- ## 📋 Requirements - Home Assistant OS – apps need the Supervisor, which Home Assistant Container does not have - Supervised installations still work, but Home Assistant ended support for them with 2025.12 - Supported architecture: aarch64 or amd64 --- ## 🧩 Home Assistant Integration The app runs BamBuddy; the [BamBuddy integration](https://github.com/Spegeli/hacs_bambuddy) (HACS) brings your printers into Home Assistant: entities for status, AMS, camera and controls, plus a dashboard card. When you set it up, enter the address you open BamBuddy with, e.g. `http://homeassistant.local:8000` (not `localhost`), and an API key created in BamBuddy. --- ## 📦 Installation ### Via button (Recommended) [](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https://github.com/Spegeli/homeassistant-app-bambuddy) **One-Click Install:** Click the button above to add the repository directly to Home Assistant! ### Manually 1. In Home Assistant, go to **Settings → Apps → App Store**. 2. Click the three dots `⋮` in the top right corner and choose **Repositories**. 3. Paste the repository URL and click **Add**: ```text https://github.com/Spegeli/homeassistant-app-bambuddy ``` --- Once the repository is added, you'll find **two versions** of BamBuddy available: | Version | Description | |---|---| | **BamBuddy** | ✅ Stable release — recommended for most users | | **BamBuddy (Daily)** | 🔬 Daily build — cutting-edge, least stable | Install your preferred version and follow the configuration steps. --- ## 🔄 Automatic Updates This App includes automatic update tracking for both versions (Stable and Daily). Updates are checked **every hour**. As soon as a new BamBuddy release is available, it will automatically appear in Home Assistant — ready to install with a single click, just like any other App update. No manual intervention required. 🎉 --- ## 💾 Data Persistence All data (print archive, settings, logs) is stored persistently in the app's configuration folder (`addon_configs` → `[slug]_bambuddy` or `[slug]_bambuddy_daily`), which is accessible via the **File Editor** in Home Assistant. Your data is safe across updates and restarts. **Uninstalling:** Home Assistant warns that the app's *private data folder* will be permanently deleted. BamBuddy stores its own data (database, print archive, logs) in the configuration folder instead, so this warning does not affect it. What decides is the switch **"Also delete the app's configuration folder (if used)"**: - **Off** (default): your BamBuddy data stays and is used again after a reinstall. - **On**: all BamBuddy data is permanently deleted. The app options from the **Configuration** tab are reset to their defaults on uninstall. --- ## ⚠️ Known Limitations ### HA Ingress — Not Supported HA Ingress is currently **not supported** and is not planned. BamBuddy's SPA architecture relies on a stable origin for API calls, routing, PWA scope, and service workers — all of which are incompatible with HA Ingress's rotating per-session subpaths. This would require extensive rewrites to BamBuddy core. ### Virtual Printer — Potential Port Conflicts When using BamBuddy's Virtual Printer feature, several ports will be bound directly on the Home Assistant host. This may conflict with other installed Apps or services (most notably the **Mosquitto MQTT Broker** on port 8883). For a full list of affected ports and details, see the **Documentation** tab of the respective App. --- ## ⚖️ Disclaimer - **Not a BamBuddy or Bambu Lab product.** This app is an independent community project that packages [BamBuddy](https://github.com/maziggy/bambuddy) for Home Assistant — all credit for BamBuddy itself goes to maziggy. Neither the BamBuddy project nor Bambu Lab develops, endorses or supports the app, and their support cannot help with it — use the [GitHub issue tracker](https://github.com/Spegeli/homeassistant-app-bambuddy/issues) instead. Bugs in BamBuddy itself still belong in the [BamBuddy project](https://github.com/maziggy/bambuddy/issues). - **Trademarks.** Bambu Lab, BamBuddy, their logos and other product names belong to their respective owners. They appear here only to name the software this app packages and the printers it works with. - **Use at your own risk.** The app is provided as is, without warranty — the packaging under the MIT License, BamBuddy under the AGPL-3.0 (see [LICENSE](LICENSE)). --- ## 📜 License This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details. It covers the app packaging: the Dockerfiles, `config.yaml`, the run scripts, the workflows, the documentation and the translations. The container images also contain **BamBuddy**, a separate work by maziggy, redistributed unmodified under the **GNU Affero General Public License v3.0** (AGPL-3.0-only). Its source code is available at [github.com/maziggy/bambuddy](https://github.com/maziggy/bambuddy). The MIT License does not cover BamBuddy's name and logo (`logo.png` and `icon.png`), which remain their owner's (see [Disclaimer](#%EF%B8%8F-disclaimer)).