bambu_mqtt/README.md

BambuLab MQTT Bridge

This project provides a bridge between a BambuLab 3D printer and an MQTT broker. It allows you to forward status and event messages from your printer to any MQTT-compatible system, enabling easy integration with home automation, monitoring, or logging solutions.

Features

• Connects securely to a BambuLab printer via MQTT over TLS
• Forwards all printer messages to a target MQTT broker
• Supports custom topic prefixing to avoid collisions
• Runs as a minimal, secure Docker container (multi-arch: amd64 & arm64)
• Configuration via environment variables or .env file

Usage

1. Configuration

Create a .env file in the project directory or provide the following environment variables:

PRINTER_IP=192.168.1.100
PRINTER_ACCESS_CODE=your_printer_code
PRINTER_SERIAL=your_printer_serial
TARGET_BROKER_IP=mqtt.example.com
TARGET_PORT=8883
TARGET_USERNAME=mqttuser
TARGET_PASSWORD=mqttpassword
TARGET_PREFIX=bambulab/

2. Build Docker Image

docker build -t bambu-mqtt .

3. Run Container

docker run --rm \
  --env-file .env \
  bambu-mqtt

Or set environment variables directly with -e.

4. Portainer/Compose Example

services:
  bambu-mqtt:
    image: git.mars3142.dev/mars3142/bambu_mqtt:latest
    env_file:
      - .env
    restart: unless-stopped

Development

• Python dependencies are managed via requirements.txt.
• The code is fully commented in English.
• The Dockerfile follows best practices: non-root, multi-arch, healthcheck, minimal size.

Versioning & CI

• The Docker image is automatically built and pushed for amd64 and arm64 via Gitea Actions.
• Image tags are derived from the version label in the Dockerfile.

License

MIT License

Author

Peter Siegmund (mars3142@noreply.mars3142.dev) ChatGPT