Community Add-ons¶

Third-party projects that extend Bambuddy — built by the community, for the community. These are independent projects maintained outside the main Bambuddy repository, talking to Bambuddy through its public API.

Want to build one?

Bambuddy exposes a documented REST API and supports API keys for headless integrations. If you build something cool, open a PR on the wiki repo to add it here.

Independent projects

Community add-ons are maintained by their respective authors, not by the Bambuddy team. Issues and feature requests for an add-on belong on its own repository.

Hardware¶

Bambutton ¶

ESP32-C3 wireless button that lets you mark the build plate clear at the printer with a single press, so the next queued job can be dispatched automatically. Includes an LED ring that signals when a plate needs clearing.

Author: Edward Chamberlain · Repository

ESPHome Bambu Spool Reader ¶

ESPHome firmware for a Waveshare ESP32-S3 with PN532 NFC reader and 2.8" touchscreen. Reads Bambu Lab spool tags and syncs them with Bambuddy — looks up known spools by tag UID, displays remaining weight, and can register new spools straight from the device.

Author: bemble · Repository

ESP Virtual Printer ¶

ESP-IDF firmware for an ESP32-S3 with PSRAM that presents an archive-only Bambu virtual printer on the LAN. Slicers discover it like a real printer and upload .3mf files over implicit FTPS; the ESP streams the bytes straight into Bambuddy as a chunked HTTP upload — no SD card, no local storage. Works with the bundled buddy_recv.py sidecar today.

Author: mengxyz · Repository

Mobile Apps¶

BuddyDash ¶

Unofficial Android companion app for Bambuddy — a mobile-first dashboard for quick status checks, multi-printer overview, archives browsing, and smart-outlet control. The standout is NFC quick actions: stick a tag on the printer and tap it to clear the plate, toggle power (with idle-safety checks), or run a finish workflow — no app navigation needed. Built with Jetpack Compose, with layouts optimised for phones, foldables, and tablets. Connects to your existing Bambuddy server through the REST API; it's a companion, not a replacement.

Beta

The author flags BuddyDash as beta — expect rough edges and breaking changes. Track the repo for stable releases.

Author: ChronosWing · Repository

Home Automation¶

Hubitat Driver ¶

Hubitat Elevation driver that talks to Bambuddy over REST (and optionally MQTT). Lets you wire Bambu Lab printer state and commands — clear plate, light on/off, pause/resume/stop — into your home-automation rules and physical buttons.

Author: jc21 · Repository

Home Assistant Sidecar Add-ons ¶

Home Assistant Add-on repository that packages Bambuddy's optional sidecar containers as one-click HA add-ons. Includes the OrcaSlicer API sidecar for server-side slicing — add the repository URL in Home Assistant's add-on store and install without writing any Docker Compose.

Author: Jan-Tobias Zimpel · Repository

Home Assistant App (Bambuddy)¶

Home Assistant Add-on repository that packages Bambuddy itself as a first-class HA App for Supervised / HA OS installations. Ships three flavours — stable, beta, and daily — with hourly update checks, so new Bambuddy releases appear directly in the HA App Store. Data is persisted in addon_configs across upgrades. Note: HA Ingress is not supported (SPA + service worker constraints).

Author: Spegeli · Repository

HACS Integration ¶

HACS custom integration that exposes a Bambuddy instance to Home Assistant. Adds each printer as a device with sensors (status, progress, layer, temperatures, fan speeds, HMS, diagnostics), a camera entity, the print-job cover image, pause / resume / stop / clear-plate buttons, a chamber-light switch, and a print-speed select. Also surfaces instance-level stats (total prints, filament used, disk usage).

Under active development

The author explicitly flags this integration as not yet production-ready — expect breaking changes and incomplete features. Track the repo for stable releases.

Author: Spegeli · Repository

Filament & Inventory¶

FilaMan Bambuddy Plugin ¶

FilaMan driver plugin that connects FilaMan to Bambuddy. Receives real-time AMS slot data via WebSocket, supports manual and automatic spool assignment, and optionally syncs FilaMan's spool inventory into Bambuddy.

Author: FilaMan / Fire-Devils · Repository

CSV Spool Import ¶

Python toolkit for managing Bambuddy's filament inventory from the command line. Bulk-imports spools from a CSV file (mapping your existing spool IDs to Bambuddy catalog IDs), lists existing spools, and generates printable QR-code PDF labels for physical spool identification. Talks to Bambuddy through its public REST API with an API key — useful for migrating from other inventory tools.

Author: bsaunder · Repository

Spoolman Cost Sync ¶

Python sidecar that copies per-spool prices from Spoolman into Bambuddy's local cost_per_kg field, so per-print cost calculations reflect what each spool actually cost. Read-only against Spoolman, writes only cost_per_kg on Bambuddy — matches RFID-linked spools by tray_uuid / tag_uid and runs on a configurable interval (default 10 min). Stdlib-only; ships as a Docker sidecar.

Author: ojimpo · Repository

Spool NFC PWA ¶

Mobile Progressive Web App for reading and writing OpenTag3D NFC tags (NTAG213/215/216) on unofficial filament spools straight from your phone. Scan a tag to find or link a spool, browse the inventory with material filters and remaining-weight indicators, assign spools to AMS and external slots, and update weights — all over Bambuddy's REST API with an API key. Installs as a PWA on Android and desktop Chrome, and credentials stay in the browser only. NFC writing needs Chrome on Android with Web NFC; iOS can install the PWA but cannot use NFC.

Author: Poltavtcev · Repository

BambuMan ¶

Android (built-in NFC) and Windows (PCSC reader like ACR122U) app that reads Bambu Lab spool NFC tags and imports them straight into your Bambuddy inventory. Matches each tag against SpoolmanDB so vendor, material, color, weight, and the corresponding Bambuddy slicer preset are filled in automatically; subsequent scans update the existing spool by tray_uuid instead of duplicating. Backend is selectable between Bambuddy and Spoolman in settings, so the spool the AMS reports over MQTT lines up with the one BambuMan imported. Distributed on Google Play and F-Droid; the project also runs its own public NFC tag library at bambuman.ee.

Author: bambuman · Repository

bambuddy-cli ¶

Terminal companion for assigning AMS slots and editing print-archive metadata without opening the web UI. Closes the AMS Lite gap — AMS Lite cannot read RFID, so third-party spools show up as occupied-but-unknown; the CLI calls Bambuddy's assignment API directly to map any inventory spool to any unit/slot. Also patches archived prints (cost, notes, tags, status, failure reason, external URL) from one-shot commands or an interactive picker. Talks to Bambuddy over the REST API with host + printer ID from .env or flags; shells out to curl to dodge a macOS IPv6 socket quirk.

Author: mailletf · Repository

Bots & Notifications¶

:material-discord: Discord Print Queue Bot ¶

Discord bot that turns a Forum channel into a print queue. Members submit .gcode.3mf files via !print in a thread; superusers queue immediately, others go through an approval reaction from a designated approver. Pings the submitter when their print starts and finishes.

Author: CrazyClone55 · Repository

Signal Print Queue Bot ¶

Signal bot that turns MakerWorld links into Bambuddy print jobs. DM the bot a link and it creates a persistent Signal group, then walks you through profile / plate(s) / per-filament AMS slot selection in numbered replies, re-slices for your target printer, and queues each plate through Bambuddy's REST API. Group commands give live progress with a camera snapshot (!progress), the current queue (!queue), and cancel-the-last-pending-job (!cancel); the bot pings the group when each queued print finishes or fails. Receives messages from an upstream dispatcher (the author's signal-router or any forwarder that hits its /claims + /receive endpoints).

Author: phieb · Repository

PrinterPrinter ¶

Local Python daemon that watches Bambuddy for print starts and auto-prints a job label on a Brother QL-820NWB. Polls Bambuddy's REST API on a configurable interval (default 5 s), detects new print events, persists them in SQLite, and renders a DK1202 (62×100 mm) label per job with filament mass and optional cost (price-per-gram × rounded grams). Admin endpoints expose /health, /admin/printers, /admin/events, and a reprint hook (POST /admin/print-event/{id}). Ships with an interactive Raspberry Pi installer for always-on deployments.

Author: FirstBuild · Repository

Deployment & Automation¶

Ansible Collection ¶

Ansible collection for installing and configuring Bambuddy at scale. Includes modules for initial setup, login/token fetch, settings, printer management, and the virtual-printer feature — all callable via delegate_to: localhost.

Author: nils-ost · Repository

Helm Chart ¶

Helm chart for running Bambuddy on Kubernetes. Pins the ghcr.io/maziggy/bambuddy image via the chart's appVersion, defaults to SQLite on a persistent volume with optional external PostgreSQL via database.externalDatabase, and persists /app/data and /app/logs on separate PVCs. Supports hostNetwork for SSDP printer discovery and grants NET_BIND_SERVICE so the virtual-printer ports (322, 990, FTP passive range) bind as a non-root user. Single-instance by design — uses the Recreate strategy so the RWO data volume is released cleanly between rollouts.

Author: npelikan · Repository

AI & Integrations¶

Bambuddy MCP Server ¶

Model Context Protocol server that exposes Bambuddy's full REST API as tools for AI assistants like Claude Desktop and Claude Code. Talk to your printers in plain language — check status, queue prints, control lights, view camera snapshots.

Author: MrMebelMan · Repository

Print Concierge ¶

Python MCP / CLI safety layer that sits between agent clients (Claude, Codex, Hermes, OpenClaw) and a Bambuddy server. Exposes a curated tool set for searching the archive, discovering models via 3DSEARCH, importing from MakerWorld / Printables / Thingiverse, slicing with explicit presets, hash-verifying outputs, and assembling deterministic print plans — but deliberately does not expose raw queue / start / pause / cancel. The only sensitive action is a scoped queue_print_request(request_id) that submits a pre-approved, plan-hash-bound request, with audit logging and Bambuddy's manual-start as the default. Talks to Bambuddy over the REST API with a least-privilege API key (BAMBUDDY_BASE_URL + BAMBUDDY_API_KEY). Ships a sandbox backend mode for no-hardware demos.

Author: dpdev69 · Repository

Contributing an add-on¶

If you've built something that integrates with Bambuddy — hardware, browser extensions, mobile shortcuts, scripts, dashboards, anything — we'd love to list it here.

To submit:

Make sure the project has a clear README and a license.
Open a PR against the wiki repository adding a page under docs/community/ and a card on this hub page.
Keep it interoperability-focused — add-ons should use Bambuddy's public API, not internal endpoints.

Questions? Drop into the Discord.