Bambuddy Wiki

Welcome to the Bambuddy documentation! Bambuddy is a self-hosted print archive and management system for Bambu Lab 3D printers.

Quick Links

Getting Started	Features	Reference
Installation	Print Archiving	API Documentation
Getting Started	Real-time Monitoring	Troubleshooting
Adding Your First Printer	Print Queue & Scheduling	Environment Variables

Feature Documentation

Core Features

Print Archiving - Automatic 3MF archiving with metadata extraction
Real-time Monitoring - Live printer status, temperatures, and progress
Statistics Dashboard - Print analytics, success rates, and cost tracking

Automation

Print Queue & Scheduling - Schedule prints with smart plug automation
Smart Plug Integration - Tasmota-based power control and monitoring
Push Notifications - Multi-provider alerts (WhatsApp, Telegram, Discord, etc.)

Integrations

Spoolman Integration - Filament inventory sync
Cloud Profiles - Bambu Cloud slicer preset management
K-Profiles - Pressure advance settings management

Maintenance & Management

Maintenance Tracker - Schedule and track printer maintenance
File Manager - Browse and manage printer SD card files
External Links - Add custom sidebar links to external tools

Supported Printers

Series	Models	Status
H2 Series	H2C, H2D, H2S	Tested (H2D)
X1 Series	X1, X1 Carbon	Tested (X1C)
P1 Series	P1P, P1S	Needs Testing
A1 Series	A1, A1 Mini	Needs Testing

Testers Needed! If you have a printer model that needs testing, please help by reporting your experience in GitHub Issues.

Requirements

Python 3.10+ (3.11 or 3.12 recommended)
Node.js 18+ (only for building frontend from source)
Bambu Lab printer with LAN Mode enabled
Printer and server on the same local network

Need Help?

Check the Troubleshooting guide
Search existing issues
Open a new issue if you're stuck