🇫🇷 Français · 🇬🇧 English

🎨 Bambu Dashboard

Dépôt d'add-ons Home Assistant pour suivre, inventorier et optimiser tes bobines Bambu Lab

MQTT LAN direct · AMS temps réel · Inventaire bobines · KPIs · Scan NFC Flipper Zero & Android

---

✨ Ce que tu obtiens

🖨️ AMS temps réel	Les 4 slots, couleur, type, poids restant, affichés en direct via MQTT TLS
📦 Inventaire persistant	Catalogue des bobines avec réconciliation auto tray_uuid → active/idle/empty/archived
📊 KPIs	Consommation totale, sessions, top matériaux, 7/30 derniers jours
🏷️ Scan NFC Bambu	Lecture des tags des bobines 2024+ via un Flipper Zero ou un téléphone Android compatible NFC
🚫 Zéro Cloud Bambu	Tout est local, LAN uniquement, pas de compte requis

---

🚀 Installation en 30 secondes

1️⃣ Ouvre Paramètres → Modules complémentaires → Boutique

2️⃣ Menu ⋮ (en haut à droite) → Dépôts

3️⃣ Colle l'URL ci-dessous et clique Ajouter :

https://github.com/coom/BambuBoard

4️⃣ La section Bambu Dashboard Add-ons apparaît ✨

5️⃣ Clique Bambu Dashboard → Installer

6️⃣ Renseigne printer_ip, printer_serial, printer_access_code

7️⃣ Démarrer → Ouvrir l'interface Web 🎉

---

📦 Add-ons inclus

Add-on	Description	Version
🎨 Bambu Dashboard	Dashboard complet : AMS, inventaire, KPIs, scan NFC

---

📱 Application Android (optionnel mais pratique)

Le dossier android/bambu_scanner/ contient une app Android compagnon qui scanne les tags NFC des bobines Bambu Lab directement avec ton téléphone et les envoie au dashboard en un tap.

💡 APK prêt à l'emploi : télécharge android/bambu_scanner/dist/bambu_scanner.apk, installe-le sur ton téléphone — c'est tout.

Compatible : Samsung, Pixel (Tensor), OnePlus et tout téléphone avec chip NFC NXP (MIFARE Classic). Android 7.0+.

Le guide complet (configuration du dashboard, utilisation, dépannage) est dans le README de l'app Android.

---

🛰️ Plugin Flipper Zero (optionnel mais cool)

Le dossier flipper/bambu_scanner/ contient une app Flipper Zero qui scanne les tags NFC des bobines Bambu Lab (clés dérivées par UID, compatibles bobines 2024+) et envoie les métadonnées au dashboard via USB Web Serial.

💡 Bonne nouvelle : un .fap pré-compilé (SDK officiel 1.4.3) est directement versionné à flipper/bambu_scanner/dist/bambu_scanner.fap.

Pas besoin de Python, d'ufbt, ni de toolchain — télécharge, drag-and-drop dans qFlipper, c'est installé. ✨

Les détails (build custom, firmware alternatif, troubleshooting) sont dans le README du plugin.

---

🏗️ Architecture

┌────────────────┐   MQTT TLS :8883   ┌─────────────────────┐
│   Imprimante   │ ──────────────────▶│   bambu_dashboard   │
│   Bambu Lab    │      (LAN only)    │     (add-on HA)     │
└────────────────┘                    └──────────┬──────────┘
                                                 │
                          ┌───────────────┬──────┼──────────────────────┐
                          │               │      │                      │
                          ▼               ▼      ▼                      ▼
                  HTTPS ingress HA   Port 8000  Webhook HA       Web Serial API
                          │               │      │                      │
                          ▼               ▼      ▼                      ▼
                  ┌──────────────┐  ┌──────────┐ ┌─────────────┐ ┌──────────────┐
                  │  Navigateur  │  │ Android  │ │  HA Notify  │ │ Flipper Zero │
                  │ (SPA vanilla)│  │  NFC App │ │   (mobile)  │ │ bambu_scanner│
                  └──────────────┘  └──────────┘ └─────────────┘ └──────────────┘

---

✅ Compatibilité

🖨️ Imprimantes	Toute Bambu Lab avec AMS — X1 / X1C / X1E / P1S / P1P / A1 / A1 mini
🏗️ Architectures HA	amd64 · aarch64 · armv7
🌐 Navigateurs (scan NFC)	Chrome ou Edge uniquement — Web Serial API requise
📡 Mode imprimante	LAN uniquement ou LAN + Cloud (MQTT local obligatoire)

---

👥 Crédits

Rôle	Personne
🧑‍💻 Auteur principal	Erti (add-on HA : backend FastAPI, frontend SPA, inventaire, KPIs, intégration NFC côté dashboard)
🛰️ Contributeur majeur	coom (plugin Flipper Zero bambu_scanner, application Android Bambu Scanner)

💡 Contributions upstream (KDF BambuTagger, parser dérivé de flipper-bambu) détaillées dans le README du plugin Flipper.

---

📜 Licence

Le code du dashboard est sous MIT.

⚠️ L'app Flipper Zero utilise une KDF (bambu_crypto.c/h) importée de ductai199x/BambuTagger sous licence "educational and personal use". Voir le README du plugin.

---

Fait avec ❤️ et beaucoup de filament PLA par Erti (avec coom pour le Flipper et l'app Android)