Das **Bambuddy-Plugin** ist ein Driver-Plugin, das FilaMan mit [Bambuddy](https://github.com/your-org/bambuddy) – einer alternativen Verwaltungsoberfläche für BambuLab-Drucker – verbindet. Es synchronisiert den FilaMan-Spulenbestand bidirektional mit dem Bambuddy-Inventory und meldet Filamentverbrauch automatisch nach dem Druck zurück.

**Installation:** → [Admin: Plugin-Verwaltung](/Docs/De/11-Admin#115-system-plugin-verwaltung)

---

| Eigenschaft | Wert |

|-------------|------|

| **Plugin-Typ** | Driver (Druckertreiber) |

| **Autor** | FilaMan |

| **Verbindung** | HTTP REST API + WebSocket |

| **Fähigkeiten** | Inventory-Sync, AMS-Slot-Anzeige, Verbrauchsmeldung, Online/Offline-Erkennung |

---

- Ein laufender **Bambuddy-Server**, der über das Netzwerk erreichbar ist

- Ein gültiger **API-Key** aus den Bambuddy-Einstellungen

- Die **Drucker-ID** des Bambudruckers in Bambuddy (zu finden in der Bambuddy-Weboberfläche)

---

Beim Hinzufügen oder Bearbeiten eines Bambuddy-Druckers zeigt das Plugin folgende Konfigurationsfelder:

| Feld | Pflicht | Beschreibung |

|------|---------|-------------|

| **Bambuddy URL** | Ja | Vollständige URL zum Bambuddy-Server (z. B. `http://192.168.1.100:8080`) |

| **API Key** | Ja | API-Key aus den Bambuddy-Einstellungen (unter Bambuddy → Settings → API) |

| **Printer ID** | Ja | ID des Druckers in Bambuddy (numerisch, sichtbar in der Bambuddy-Druckerübersicht) |

| **Sync Interval** | Nein | Intervall in Sekunden für den automatischen Inventory-Sync (Standard: 300 = 5 Minuten) |

| **Reconnect Interval** | Nein | Wartezeit in Sekunden bei Verbindungsverlust vor erneutem Verbindungsversuch (Standard: 30) |

---

Das Plugin hält das **Bambuddy-Inventory** automatisch aktuell – FilaMan ist dabei die Quelle der Wahrheit.

| Auslöser | Verhalten |

|---------|-----------|

| **Beim Start des Plugins** | Vollständiger Inventory-Sync aller aktiven FilaMan-Spulen |

| **Periodisch** | Automatisch alle `Sync Interval` Sekunden (Standard: alle 5 Minuten) |

| **Bei Änderungen in FilaMan** | Sofortiger Sync innerhalb von 3 Sekunden nach jeder Datenänderung (Spule erstellt, Gewicht aktualisiert, Filament geändert etc.) |

Jede in Bambuddy erstellte Spule erhält im Feld **„Note"** den Wert `filaman:{id}` (z. B. `filaman:42`). Dieser Schlüssel ist die eindeutige Verknüpfung zwischen FilaMan-Spule und Bambuddy-Inventory-Eintrag. Wird die gleiche FilaMan-Spule erneut synchronisiert, aktualisiert das Plugin den bestehenden Bambuddy-Eintrag anstatt einen neuen zu erstellen.

---

Bei jedem Sync überträgt das Plugin folgende Informationen aus FilaMan nach Bambuddy:

| FilaMan-Feld | Bambuddy-Feld | Beschreibung |

|---|---|---|

| `filament.material_type` | Material | Materialtyp (PLA, PETG, ABS …) |

| `filament.manufacturer.name` | Marke | Hersteller |

| `filament.colors[0].hex_code` | Farbe (RGBA) | Hauptfarbe der Spule |

| `initial_total_weight_g` | Nenngewicht | Ursprüngliches Gesamtgewicht |

| `initial – remaining` | Verbrauchtes Gewicht | Bereits verbrauchtes Gewicht |

| `rfid_uid` | RFID-Tag | Wird übertragen, wenn vorhanden |

| `bambu_nozzle_temp_min/max` | Düsentemperaturen | Aus den Drucker-Parametern |

---

Das Plugin hält eine **WebSocket-Verbindung** zum Bambuddy-Server. Wenn ein Druckauftrag abgeschlossen wird, sendet Bambuddy ein `print_complete`-Event mit dem Filamentverbrauch pro AMS-Slot. Das Plugin rechnet diesen Verbrauch automatisch auf die entsprechende FilaMan-Spule an – ohne manuelle Eingabe.

---

Nach erfolgreicher Verbindung zeigt FilaMan auf der **Drucker-Seite** und der **Spulen-Detailseite** alle AMS-Slots und deren aktuellen Inhalt an. Die Anzeige aktualisiert sich in **Echtzeit** über den WebSocket.

Ist der Bambu-Drucker **nicht erreichbar** (laut Bambuddy offline), werden auf der Spulen-Detailseite **keine Trays** für diesen Drucker angezeigt. Sobald der Drucker wieder online ist, erscheinen die Slots automatisch.

Auf der **Spulen-Detailseite** können Sie eine Spule direkt einem AMS-Slot in Bambuddy zuweisen:

1. Klicken Sie auf einen Slot-Punkt in der Drucker-Slot-Übersicht

2. Wählen Sie im Kontextmenü **„Spule diesem Slot zuweisen"**

3. Bambuddy weist die Spule dem Slot zu und konfiguriert Material, Farbe und Temperaturen automatisch

---

Auf der **Drucker-Detailseite** stehen zwei manuelle Sync-Aktionen zur Verfügung:

| Aktion | Beschreibung |

|--------|-------------|

| **Jetzt synchronisieren** | Löst sofort einen Inventory-Sync aus (FilaMan → Bambuddy) |

| **Vollständiger Resync** | Löscht **alle** Bambuddy-Inventarspulen und synchronisiert den gesamten FilaMan-Bestand neu. Sinnvoll, wenn das Inventory in Bambuddy durch externe Änderungen inkonsistent geworden ist. ⚠️ Nicht während laufender Druckaufträge ausführen. |

---

← [Zurück: Plugin: Spoolman API](/Docs/De/16-Plugin-Spoolmanapi)