# Bambuddy — Self-Hosted Command Center for Bambu Lab 3D Printers

> Bambuddy is a self-hosted web dashboard for managing Bambu Lab 3D printers without cloud dependency, offering real-time monitoring, print history, and multi-printer fleet control.

## Install

Save in your project root:

# Bambuddy — Self-Hosted Command Center for Bambu Lab 3D Printers

## Quick Use
```bash
docker run -d --name bambuddy -p 5000:5000 
  -v bambuddy_data:/app/data 
  -e PRINTER_IP=192.168.1.100 
  -e ACCESS_CODE=your_access_code 
  ghcr.io/maziggy/bambuddy:latest
# Open http://localhost:5000
```

## Introduction
Bambuddy is a self-hosted command center for Bambu Lab 3D printers. It communicates directly with printers over your local network using MQTT, eliminating the need for Bambu Lab's cloud services while providing real-time status, print history, and fleet management.

## What Bambuddy Does
- Monitors real-time printer status including temperature, progress, and filament usage
- Manages print jobs across single or multiple Bambu Lab printers
- Tracks print history with statistics on filament consumption and print time
- Provides a responsive web dashboard accessible from any device
- Operates entirely on the local network without cloud connectivity

## Architecture Overview
Bambuddy is a Python application using Flask for the web interface and Paho-MQTT to communicate with Bambu Lab printers over the local MQTT protocol. Printer state is polled and cached in a local SQLite database. The frontend is a responsive web dashboard that displays real-time telemetry. The entire stack runs in a single Docker container.

## Self-Hosting & Configuration
- Deploy via Docker with printer IP and access code as environment variables
- Find your printer's access code in the Bambu Lab app under device settings
- Add multiple printers by providing comma-separated IPs and access codes
- Mount a persistent volume for `/app/data` to retain print history
- Run on the same network as your printers; no internet access required

## Key Features
- Cloud-free operation preserves privacy and works during internet outages
- Multi-printer dashboard for managing print farms from a single view
- Real-time temperature graphs for hotend, bed, and chamber
- Print history with per-job filament usage and duration tracking
- Mobile-friendly responsive design for checking prints on the go

## Comparison with Similar Tools
- **Bambu Handy** — official mobile app, requires cloud; Bambuddy is local-only
- **Bambu Studio** — desktop slicer with monitoring; Bambuddy is web-based and always-on
- **OctoPrint** — designed for Marlin printers; Bambuddy targets Bambu Lab hardware specifically
- **Mainsail/Fluidd** — Klipper frontends; Bambuddy works with Bambu Lab's proprietary protocol
- **Home Assistant integration** — automation-focused; Bambuddy provides a dedicated print management UI

## FAQ
**Q: Which Bambu Lab printers are supported?**
A: All Bambu Lab printers that support LAN mode, including the A1, A1 mini, P1S, P1P, and X1 series.

**Q: Does Bambuddy require internet access?**
A: No. Bambuddy communicates with printers over your local network using MQTT.

**Q: Can I start and stop prints from Bambuddy?**
A: Bambuddy focuses on monitoring and history. Print job control depends on the printer model and firmware version.

**Q: How do I find my printer's access code?**
A: Open the Bambu Handy app, select your printer, go to Settings, and find the LAN access code.

## Sources
- https://github.com/maziggy/bambuddy

---
Source: https://tokrepo.com/en/workflows/asset-b1ced4d4
Author: AI Open Source