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