+
+
+FilaMan wird von [Recycling Fabrik](https://www.recyclingfabrik.com) unterstützt.
+Recycling Fabrik wird demnächst auf seinen Spulen einen FilaMan tauglichen NFC Tag anbieten. Das hat den Vorteil,
+dass die Spulen direkt über FilaMan, ganz automatisch, erkannt und in Spoolman importiert werden können.
+
+**Was ist Recycling Fabrik?**
+
+Die Recycling Fabrik ist ein deutsches Unternehmen, das sich der Entwicklung und Herstellung von nachhaltigem 3D-Druck-Filament verschrieben hat.
+Ihre Filamente bestehen zu 100 % aus recyceltem Material, welches sowohl vom Endkunden, als auch aus der Industrie stammt – für eine umweltbewusste und ressourcenschonende Zukunft.
+
+Mehr Informationen und Produkte findest du hier: [www.recyclingfabrik.com](https://www.recyclingfabrik.com)
+
+---
+
+
### Es gibt jetzt auch ein Wiki, dort sind nochmal alle Funktionen beschrieben: [Wiki](https://github.com/ManuelW77/Filaman/wiki)
### ESP32 Hardware-Funktionen
@@ -27,6 +47,7 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- Filamentdaten auf NFC-Tags schreiben.
- Verwendet das NFC-Tag-Format von [Openspool](https://github.com/spuder/OpenSpool)
- Ermöglicht automatische Spulenerkennung im AMS
+ - **Hersteller Tag Unterstützung:** Automatische Erstellung von Spoolman-Einträgen aus Hersteller NFC-Tags ([Mehr erfahren](README_ManufacturerTags_DE.md))
- **Bambulab AMS-Integration:**
- Anzeige der aktuellen AMS-Fachbelegung.
- Zuordnung von Filamenten zu AMS-Slots.
@@ -39,8 +60,35 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- Unterstützt das Spoolman Octoprint Plugin
### Wenn Sie meine Arbeit unterstützen möchten, freue ich mich über einen Kaffee
+
+## Hersteller Tags Unterstützung
+
+🎉 **Aufregende Neuigkeiten!** FilaMan unterstützt jetzt **Hersteller Tags** - NFC-Tags, die direkt von Filament-Herstellern vorprogrammiert geliefert werden!
+
+### Erster Hersteller-Partner: RecyclingFabrik
+
+Wir freuen uns anzukündigen, dass [**RecyclingFabrik**](https://www.recyclingfabrik.de) der **erste Filament-Hersteller** sein wird, der FilaMan unterstützt, indem sie NFC-Tags im FilaMan-Format auf ihren Spulen anbieten!
+
+**Demnächst verfügbar:** RecyclingFabrik-Spulen werden NFC-Tags enthalten, die sich automatisch in Ihr FilaMan-System integrieren, manuelle Einrichtung überflüssig machen und perfekte Kompatibilität gewährleisten.
+
+### Wie Hersteller Tags funktionieren
+
+Wenn Sie zum ersten Mal einen Hersteller NFC-Tag scannen:
+1. **Automatische Markenerkennung:** FilaMan erkennt den Hersteller und erstellt die Marke in Spoolman
+2. **Filament-Typ Erstellung:** Alle Materialspezifikationen werden automatisch hinzugefügt
+3. **Spulen-Registrierung:** Ihre spezifische Spule wird mit korrektem Gewicht und Spezifikationen registriert
+4. **Zukünftige Schnellerkennung:** Nachfolgende Scans verwenden Fast-Path-Erkennung für sofortige Gewichtsmessung
+
+**Für detaillierte technische Informationen:** [Hersteller Tags Dokumentation](README_ManufacturerTags_DE.md)
+
+### Vorteile für Benutzer
+- ✅ **Null manuelle Einrichtung** - Einfach scannen und wiegen
+- ✅ **Perfekte Datengenauigkeit** - Hersteller-verifizierte Spezifikationen
+- ✅ **Sofortige Integration** - Nahtlose Spoolman-Kompatibilität
+- ✅ **Zukunftssicher** - Tags funktionieren mit jedem FilaMan-kompatiblen System
+
## Detaillierte Funktionalität
### ESP32-Funktionalität
@@ -62,7 +110,7 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- **OLED 0.96 Zoll I2C white/yellow Display:** 128x64 SSD1306.
[Amazon Link](https://amzn.to/445aaa9)
- **PN532 NFC NXP RFID-Modul V3:** For NFC tag operations.
-[Amazon Link](https://amzn.to/4iO6CO4)
+[Amazon Link](https://amzn.eu/d/gy9vaBX)
- **NFC Tags NTAG213 NTAG215:** RFID Tag
[Amazon Link](https://amzn.to/3E071xO)
- **TTP223 Touch Sensor (optional):** For reTARE per Button/Touch
diff --git a/README.md b/README.md
index a1238f1..cfef460 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,25 @@ or my website: [FilaMan Website](https://www.filaman.app)
german explanatory video: [Youtube](https://youtu.be/uNDe2wh9SS8?si=b-jYx4I1w62zaOHU)
Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
+## NEW: Recycling Fabrik
+
+
+
+
+
+FilaMan is supported by [Recycling Fabrik](https://www.recyclingfabrik.com).
+Recycling Fabrik will soon offer a FilaMan-compatible NFC tag on their spools. This has the advantage
+that the spools can be automatically recognized and imported into Spoolman directly via FilaMan.
+
+**What is Recycling Fabrik?**
+
+Recycling Fabrik is a German company dedicated to developing and manufacturing sustainable 3D printing filament.
+Their filaments are made from 100% recycled material from both end customers and industry – for an environmentally conscious and resource-saving future.
+
+More information and products can be found here: [www.recyclingfabrik.com](https://www.recyclingfabrik.com)
+
+---
+
### Now more detailed informations about the usage: [Wiki](https://github.com/ManuelW77/Filaman/wiki)
### ESP32 Hardware Features
@@ -31,6 +50,7 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- Write filament data to NFC tags.
- uses NFC-Tag Format of [Openspool](https://github.com/spuder/OpenSpool)
- so you can use it with automatic Spool detection in AMS
+ - **Manufacturer Tag Support:** Automatic creation of Spoolman entries from manufacturer NFC tags ([Learn more](README_ManufacturerTags_EN.md))
- **Bambulab AMS Integration:**
- Display current AMS tray contents.
- Assign filaments to AMS slots.
@@ -43,8 +63,35 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- Supports Spoolman Octoprint Plugin
### If you want to support my work, i would be happy to get a coffe
+
+## Manufacturer Tags Support
+
+🎉 **Exciting News!** FilaMan now supports **Manufacturer Tags** - NFC tags that come pre-programmed directly from filament manufacturers!
+
+### First Manufacturer Partner: RecyclingFabrik
+
+We're thrilled to announce that [**RecyclingFabrik**](https://www.recyclingfabrik.de) will be the **first filament manufacturer** to support FilaMan by offering NFC tags in the FilaMan format on their spools!
+
+**Coming Soon:** RecyclingFabrik spools will include NFC tags that automatically integrate with your FilaMan system, eliminating manual setup and ensuring perfect compatibility.
+
+### How Manufacturer Tags Work
+
+When you scan a manufacturer NFC tag for the first time:
+1. **Automatic Brand Detection:** FilaMan recognizes the manufacturer and creates the brand in Spoolman
+2. **Filament Type Creation:** All material specifications are automatically added
+3. **Spool Registration:** Your specific spool is registered with proper weight and specifications
+4. **Future Fast Recognition:** Subsequent scans use fast-path detection for instant weight measurement
+
+**For detailed technical information:** [Manufacturer Tags Documentation](README_ManufacturerTags_EN.md)
+
+### Benefits for Users
+- ✅ **Zero Manual Setup** - Just scan and weigh
+- ✅ **Perfect Data Accuracy** - Manufacturer-verified specifications
+- ✅ **Instant Integration** - Seamless Spoolman compatibility
+- ✅ **Future-Proof** - Tags work with any FilaMan-compatible system
+
## Detailed Functionality
### ESP32 Functionality
@@ -66,7 +113,7 @@ Discord Server: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
- **OLED 0.96 Zoll I2C white/yellow Display:** 128x64 SSD1306.
[Amazon Link](https://amzn.to/445aaa9)
- **PN532 NFC NXP RFID-Modul V3:** For NFC tag operations.
-[Amazon Link](https://amzn.to/4iO6CO4)
+[Amazon Link](https://amzn.eu/d/gy9vaBX)
- **NFC Tags NTAG213 NTAG215:** RFID Tag
[Amazon Link](https://amzn.to/3E071xO)
- **TTP223 Touch Sensor (optional):** For reTARE per Button/Touch
diff --git a/README_ManufacturerTags_DE.md b/README_ManufacturerTags_DE.md
new file mode 100644
index 0000000..bd46b35
--- /dev/null
+++ b/README_ManufacturerTags_DE.md
@@ -0,0 +1,159 @@
+# Hersteller Tags - Deutsche Dokumentation
+
+## Überblick
+
+Das FilaMan NFC-System unterstützt **Hersteller Tags**, die es Filament-Produzenten ermöglichen, standardisierte NFC-Tags für ihre Produkte zu erstellen. Beim Scannen dieser Tags werden automatisch die notwendigen Einträge in Spoolman (Marke, Filament-Typ und Spule) erstellt, ohne dass eine manuelle Einrichtung erforderlich ist.
+
+## Funktionsweise der Hersteller Tags
+
+### Ablauf
+
+1. **Tag-Erkennung**: Wenn ein Tag ohne `sm_id` gescannt wird, prüft das System auf Hersteller Tag Format
+2. **Marken-Erstellung/Suche**: Das System sucht die Marke in Spoolman oder erstellt sie, falls sie nicht existiert
+3. **Filament-Typ-Erstellung/Suche**: Der Filament-Typ wird basierend auf Marke, Material und Spezifikationen erstellt oder gefunden
+4. **Spulen-Erstellung**: Ein neuer Spulen-Eintrag wird automatisch mit der Tag-UID als Referenz erstellt
+5. **Tag-Update**: Der Tag wird mit der neuen Spoolman Spulen-ID (`sm_id`) aktualisiert
+
+### Warum Hersteller Tags verwenden?
+
+- **Automatische Integration**: Keine manuelle Dateneingabe erforderlich
+- **Standardisiertes Format**: Konsistente Produktinformationen verschiedener Hersteller
+- **Lagerverwaltung**: Automatische Erstellung vollständiger Spoolman-Einträge
+- **Rückverfolgbarkeit**: Direkte Verbindung zwischen physischem Produkt und digitalem Inventar
+
+## Tag-Format Spezifikation
+
+### JSON-Struktur
+
+Hersteller Tags müssen eine JSON-Payload mit spezifischen Feldern enthalten, die **kurze Schlüssel** verwenden, um die Tag-Größe zu minimieren:
+
+```json
+{
+ "b": "Marke/Hersteller Name",
+ "an": "Artikelnummer",
+ "t": "Filament Typ (PLA, PETG, etc)",
+ "c": "Filament Farbe ohne # (FF5733)",
+ "mc": "Optional Mehrfarben-Filament Farben ohne # (FF0000,00FF00,0000FF)",
+ "mcd": "Optional Mehrfarben-Richtung als Wort (coaxial, longitudinal)",
+ "cn": "Farbname (rot, Blaubeere, Arktisches Blau)",
+ "et": "Extruder Temp als Zahl in C° (230)",
+ "bt": "Bett Temp als Zahl in C° (60)",
+ "di": "Durchmesser als Float (1.75)",
+ "de": "Dichte als Float (1.24)",
+ "sw": "Leeres Spulengewicht als Zahl in g (180)",
+ "u": "URL zum Filament mit der Artikelnummer"
+}
+```
+
+### Pflichtfelder
+
+- **`b`** (brand): Hersteller/Markenname
+- **`an`** (article number): Eindeutige Produktkennung
+- **`t`** (type): Materialtyp (PLA, PETG, ABS, etc.)
+- **`c`** (color): Hex-Farbcode ohne #
+- **`cn`** (color name): Lesbare Farbbezeichnung
+- **`et`** (extruder temp): Empfohlene Extruder-Temperatur in Celsius
+- **`bt`** (bed temp): Empfohlene Bett-Temperatur in Celsius
+- **`di`** (diameter): Filamentdurchmesser in mm
+- **`de`** (density): Materialdichte in g/cm³
+- **`sw`** (spool weight): Leeres Spulengewicht in Gramm
+
+### Optionale Felder
+
+- **`mc`** (multicolor): Komma-getrennte Hex-Farben für Mehrfarben-Filamente
+- **`mcd`** (multicolor direction): Richtung für Mehrfarben (coaxial, longitudinal)
+- **`u`** (url): Produkt-URL mit direktem Link zum Artikel zB für Nachbestellung
+
+### Beispiel Tag
+
+```json
+{"b":"Recycling Fabrik","an":"FX1_PETG-S175-1000-DAEM00055","t":"PETG","c":"FF5733","cn":"Lebendiges Orange","et":"230","bt":"70","di":"1.75","de":"1.24","sw":"180","u":"https://www.recyclingfabrik.com/search?q="}
+```
+
+## Implementierungsrichtlinien
+
+### Für Hersteller
+
+1. **Tag-Kodierung**: NDEF-Format mit MIME-Typ `application/json` verwenden
+2. **Datenminimierung**: Kompaktes JSON-Format für Tag-Größenbegrenzungen nutzen
+3. **Qualitätskontrolle**: Sicherstellen, dass alle Pflichtfelder vorhanden und korrekt formatiert sind
+4. **Testen**: Tags vor der Produktion mit dem FilaMan-System verifizieren
+
+### Tag-Größe Überlegungen
+
+- **NTAG213**: 144 Bytes Nutzerdaten (geeignet für einfache Tags)
+- **NTAG215**: 504 Bytes Nutzerdaten (empfohlen für umfassende Daten)
+- **NTAG216**: 888 Bytes Nutzerdaten (maximale Kompatibilität)
+
+### Best Practices
+
+- Markennamen über alle Produkte hinweg konsistent halten
+- Standardisierte Materialtypnamen verwenden (PLA, PETG, ABS, etc.)
+- Genaue Temperaturempfehlungen angeben
+- Aussagekräftige Farbnamen für bessere Benutzererfahrung verwenden
+- Tags vor Massenproduktion mit dem FilaMan-System testen
+
+## System-Integration
+
+### Spoolman Datenbankstruktur
+
+Bei der Verarbeitung eines Hersteller Tags erstellt das System:
+
+1. **Lieferanten-Eintrag**: Markeninformationen in der Spoolman Lieferanten-Datenbank
+2. **Filament-Eintrag**: Materialspezifikationen und Eigenschaften
+3. **Spulen-Eintrag**: Einzelne Spule mit Gewicht und NFC-Tag-Referenz
+
+### Fast-Path Erkennung
+
+Sobald ein Tag verarbeitet und mit `sm_id` aktualisiert wurde, nutzt er das Fast-Path-Erkennungssystem für schnelle nachfolgende Scans.
+
+## Fehlerbehebung
+
+### Häufige Probleme
+
+- **Tag zu klein**: NTAG215 oder NTAG216 für größere JSON-Payloads verwenden
+- **Fehlende Felder**: Sicherstellen, dass alle Pflichtfelder vorhanden sind
+- **Ungültiges Format**: JSON-Syntax und Feldtypen überprüfen
+- **Spoolman-Verbindung**: Sicherstellen, dass FilaMan mit der Spoolman API verbinden kann
+
+### Validierung
+
+Das System validiert:
+
+- JSON-Format Korrektheit
+- Vorhandensein der Pflichtfelder
+- Datentyp-Konformität
+- Tag-Größe Kompatibilität
+
+## Technische Details
+
+### Verarbeitungsalgorithmus
+
+1. Tag-Scan erkennt kein `sm_id` Feld
+2. System prüft auf `b` (Marke) und `an` (Artikelnummer) Felder
+3. `checkVendor()` erstellt oder findet Marke in Spoolman
+4. `checkFilament()` erstellt oder findet Filament-Typ
+5. `createSpool()` erstellt neuen Spulen-Eintrag
+6. Tag wird mit neuer `sm_id` aktualisiert
+
+### Fehlerbehandlung
+
+- Graceful Fallback bei Netzwerkproblemen
+- Detaillierte Protokollierung für Debugging
+- Benutzer-Feedback bei fehlgeschlagenen Operationen
+- Wiederholungsmechanismen für temporäre Fehler
+
+### Systemverhalten
+
+#### Bei fehlendem sm_id:
+- System prüft auf `b` (brand) und `an` (artnr) Felder
+- Falls vorhanden → Hersteller Tag erkannt
+- Automatische Erstellung von Lieferant, Filament und Spule in Spoolman
+- Tag wird mit neuer `sm_id` beschrieben
+
+#### Bei vorhandenem sm_id:
+- Fast-Path Erkennung für bekannte Spulen
+- Sofortige Gewichtsmessung ohne vollständige Tag-Analyse
+- Optimierte Performance für häufig verwendete Tags
+
+Dieses System ermöglicht eine nahtlose Integration von Hersteller-Filamentprodukten in das FilaMan-Ökosystem unter Beibehaltung von Datenkonsistenz und Benutzererfahrung.
\ No newline at end of file
diff --git a/README_ManufacturerTags_EN.md b/README_ManufacturerTags_EN.md
new file mode 100644
index 0000000..f2ad5a8
--- /dev/null
+++ b/README_ManufacturerTags_EN.md
@@ -0,0 +1,145 @@
+# Manufacturer Tags - English Documentation
+
+## Overview
+
+The FilaMan NFC system supports **Manufacturer Tags** that allow filament producers to create standardized NFC tags for their products. When scanned, these tags automatically create the necessary entries in Spoolman (brand, filament type, and spool) without requiring manual setup.
+
+## How Manufacturer Tags Work
+
+### Process Flow
+
+1. **Tag Detection**: When a tag without `sm_id` is scanned, the system checks for manufacturer tag format
+2. **Brand Creation/Lookup**: The system searches for the brand in Spoolman or creates it if it doesn't exist
+3. **Filament Type Creation/Lookup**: The filament type is created or found based on brand, material, and specifications
+4. **Spool Creation**: A new spool entry is automatically created with the tag's UID as reference
+5. **Tag Update**: The tag is updated with the new Spoolman spool ID (`sm_id`)
+
+### Why Use Manufacturer Tags?
+
+- **Automatic Integration**: No manual data entry required
+- **Standardized Format**: Consistent product information across different manufacturers
+- **Inventory Management**: Automatic creation of complete Spoolman entries
+- **Traceability**: Direct link between physical product and digital inventory
+
+## Tag Format Specification
+
+### JSON Structure
+
+Manufacturer tags must contain a JSON payload with specific fields using **short keys** to minimize tag size:
+
+```json
+{
+ "b": "Brand/Vendor Name",
+ "an": "Article Number",
+ "t": "Filament Type (PLA, PETG, etc)",
+ "c": "Filament Color without # (FF5733)",
+ "mc": "Optional Multicolor Filament Colors without # (FF0000,00FF00,0000FF)",
+ "mcd": "Optional Multicolor Direction as Word (coaxial, longitudinal)",
+ "cn": "Color Name (red, Blueberry, Arctic Blue)",
+ "et": "Extruder Temp as Number in C° (230)",
+ "bt": "Bed Temp as Number in C° (60)",
+ "di": "Diameter as Float (1.75)",
+ "de": "Density as Float (1.24)",
+ "sw": "Empty Spool Weight as Number in g (180)",
+ "u": "URL to get the Filament with the Article Number"
+}
+```
+
+### Required Fields
+
+- **`b`** (brand): Manufacturer/brand name
+- **`an`** (article number): Unique product identifier
+- **`t`** (type): Material type (PLA, PETG, ABS, etc.)
+- **`c`** (color): Hex color code without #
+- **`cn`** (color name): Human-readable color name
+- **`et`** (extruder temp): Recommended extruder temperature in Celsius
+- **`bt`** (bed temp): Recommended bed temperature in Celsius
+- **`di`** (diameter): Filament diameter in mm
+- **`de`** (density): Material density in g/cm³
+- **`sw`** (spool weight): Empty spool weight in grams
+
+### Optional Fields
+
+- **`mc`** (multicolor): Comma-separated hex colors for multicolor filaments
+- **`mcd`** (multicolor direction): Direction for multicolor (coaxial, longitudinal)
+- **`u`** (url): Product URL with direct link to the article e.g. for reordering
+
+### Example Tag
+
+```json
+{"b":"Recycling Fabrik","an":"FX1_PETG-S175-1000-DAEM00055","t":"PETG","c":"FF5733","cn":"Vibrant Orange","et":"230","bt":"70","di":"1.75","de":"1.24","sw":"180","u":"https://www.recyclingfabrik.com/search?q="}
+```
+
+## Implementation Guidelines
+
+### For Manufacturers
+
+1. **Tag Encoding**: Use NDEF format with MIME type `application/json`
+2. **Data Minimization**: Use the compact JSON format to fit within tag size limits
+3. **Quality Control**: Ensure all required fields are present and correctly formatted
+4. **Testing**: Verify tags work with FilaMan system before production
+
+### Tag Size Considerations
+
+- **NTAG213**: 144 bytes user data (suitable for basic tags)
+- **NTAG215**: 504 bytes user data (recommended for comprehensive data)
+- **NTAG216**: 888 bytes user data (maximum compatibility)
+
+### Best Practices
+
+- Keep brand names consistent across all products
+- Use standardized material type names (PLA, PETG, ABS, etc.)
+- Provide accurate temperature recommendations
+- Include meaningful color names for user experience
+- Test tags with the FilaMan system before mass production
+
+## System Integration
+
+### Spoolman Database Structure
+
+When a manufacturer tag is processed, the system creates:
+
+1. **Vendor Entry**: Brand information in Spoolman vendor database
+2. **Filament Entry**: Material specifications and properties
+3. **Spool Entry**: Individual spool with weight and NFC tag reference
+
+### Fast-Path Recognition
+
+Once a tag is processed and updated with `sm_id`, it uses the fast-path recognition system for quick subsequent scans.
+
+## Troubleshooting
+
+### Common Issues
+
+- **Tag Too Small**: Use NTAG215 or NTAG216 for larger JSON payloads
+- **Missing Fields**: Ensure all required fields are present
+- **Invalid Format**: Verify JSON syntax and field types
+- **Spoolman Connection**: Ensure FilaMan can connect to Spoolman API
+
+### Validation
+
+The system validates:
+- JSON format correctness
+- Required field presence
+- Data type compliance
+- Tag size compatibility
+
+## Technical Details
+
+### Processing Algorithm
+
+1. Tag scan detects no `sm_id` field
+2. System checks for `b` (brand) and `an` (article number) fields
+3. `checkVendor()` creates or finds brand in Spoolman
+4. `checkFilament()` creates or finds filament type
+5. `createSpool()` creates new spool entry
+6. Tag is updated with new `sm_id`
+
+### Error Handling
+
+- Graceful fallback for network issues
+- Detailed logging for debugging
+- User feedback for failed operations
+- Retry mechanisms for temporary failures
+
+This system enables seamless integration of manufacturer filament products into the FilaMan ecosystem while maintaining data consistency and user experience.
\ No newline at end of file
diff --git a/WIKI_DE.md b/WIKI_DE.md
new file mode 100644
index 0000000..b4ed552
--- /dev/null
+++ b/WIKI_DE.md
@@ -0,0 +1,468 @@
+# FilaMan Wiki - Deutsch
+
+## Inhaltsverzeichnis
+
+1. [Überblick](#überblick)
+2. [Installation](#installation)
+3. [Hardware-Anforderungen](#hardware-anforderungen)
+4. [Ersteinrichtung](#ersteinrichtung)
+5. [Konfiguration](#konfiguration)
+6. [Benutzung](#benutzung)
+7. [NFC-Tags](#nfc-tags)
+8. [Bambu Lab Integration](#bambu-lab-integration)
+9. [Spoolman Integration](#spoolman-integration)
+10. [Octoprint Integration](#octoprint-integration)
+11. [Hersteller Tags](#hersteller-tags)
+12. [Fehlerbehebung](#fehlerbehebung)
+13. [Support](#support)
+
+---
+
+## Überblick
+
+FilaMan ist ein umfassendes Filament-Managementsystem für 3D-Drucker, das auf ESP32-Hardware basiert. Es bietet Gewichtsmessung, NFC-Tag-Management und nahtlose Integration mit Spoolman und Bambu Lab 3D-Druckern.
+
+### Hauptfunktionen
+
+- **Präzise Gewichtsmessung** mit HX711 Wägezellen-Verstärker
+- **NFC-Tag Lesen und Schreiben** für Filament-Identifikation
+- **OLED-Display** für Status-Anzeigen
+- **WiFi-Konnektivität** mit einfacher Konfiguration
+- **Webbasierte Benutzeroberfläche** mit Echtzeit-Updates
+- **Spoolman-Integration** für Lagerverwaltung
+- **Bambu Lab AMS-Steuerung** via MQTT
+- **Openspool NFC-Format** Kompatibilität
+- **Hersteller Tag Unterstützung** für automatische Einrichtung
+
+### Systemvoraussetzungen
+
+- **ESP32 Development Board**
+- **Spoolman Instanz** (erforderlich für volle Funktionalität)
+- **WiFi-Netzwerk**
+- **Webbrowser** (Chrome/Firefox/Safari)
+
+---
+
+## Installation
+
+### Einfache Installation (Empfohlen)
+
+1. **Öffnen Sie den [FilaMan Web-Installer](https://www.filaman.app/installer.html)**
+ - Verwenden Sie einen Chrome-basierten Browser
+
+2. **ESP32 vorbereiten**
+ - Verbinden Sie den ESP32 über USB mit Ihrem Computer
+ - Klicken Sie auf "Connect"
+
+3. **Port auswählen**
+ - Wählen Sie den entsprechenden USB-Port aus
+ - Bestätigen Sie die Auswahl
+
+4. **Installation starten**
+ - Klicken Sie auf "FilaMan installieren"
+ - Warten Sie, bis der Installationsvorgang abgeschlossen ist
+
+### Manuelle Kompilierung
+
+Für erfahrene Benutzer mit PlatformIO:
+
+```bash
+git clone https://github.com/ManuelW77/Filaman.git
+cd FilaMan/esp32
+pio lib install
+pio run --target upload
+```
+
+---
+
+## Hardware-Anforderungen
+
+### Erforderliche Komponenten
+
+| Komponente | Beschreibung | Amazon Link (Affiliate) |
+|------------|--------------|-------------------------|
+| ESP32 Development Board | Jede ESP32-Variante | [Amazon](https://amzn.to/3FHea6D) |
+| HX711 + Wägezelle | 5kg Load Cell Amplifier | [Amazon](https://amzn.to/4ja1KTe) |
+| OLED Display | 0.96" I2C 128x64 SSD1306 | [Amazon](https://amzn.to/445aaa9) |
+| PN532 NFC Modul | V3 RFID-Modul | [Amazon](https://amzn.eu/d/gy9vaBX) |
+| NFC Tags | NTAG213/NTAG215 | [Amazon](https://amzn.to/3E071xO) |
+| TTP223 Touch Sensor | Optional für Tara-Funktion | [Amazon](https://amzn.to/4hTChMK) |
+
+### Pin-Konfiguration
+
+| Komponente | ESP32 Pin | Funktion |
+|------------|-----------|----------|
+| HX711 DOUT | 16 | Datenausgang Wägezelle |
+| HX711 SCK | 17 | Takt Wägezelle |
+| OLED SDA | 21 | I2C Daten |
+| OLED SCL | 22 | I2C Takt |
+| PN532 IRQ | 32 | Interrupt |
+| PN532 RESET | 33 | Reset |
+| PN532 SDA | 21 | I2C Daten (geteilt) |
+| PN532 SCL | 22 | I2C Takt (geteilt) |
+| TTP223 I/O | 25 | Touch-Sensor (optional) |
+
+### Wichtige Hinweise
+
+- **PN532 DIP-Schalter** müssen auf I2C-Modus eingestellt sein
+- **3V Pin** vom ESP32 für Touch-Sensor verwenden
+- **Wägezellen-Verkabelung**: E+ (rot), E- (schwarz), A- (weiß), A+ (grün)
+
+
+
+---
+
+## Ersteinrichtung
+
+### Nach der Installation
+
+1. **ESP32 Neustart**
+ - Das System erstellt automatisch einen WiFi-Hotspot "FilaMan"
+
+2. **WiFi-Konfiguration**
+ - Verbinden Sie sich mit dem "FilaMan" Netzwerk
+ - Öffnen Sie einen Browser (automatisches Portal oder http://192.168.4.1)
+ - Konfigurieren Sie Ihre WiFi-Zugangsdaten
+
+3. **Erster Zugriff**
+ - Nach erfolgreicher WiFi-Verbindung ist das System unter http://filaman.local erreichbar
+ - Alternativ über die vom Router zugewiesene IP-Adresse
+
+### Spoolman Vorbereitung
+
+**Wichtiger Hinweis**: Spoolman muss im Debug-Modus laufen:
+
+```env
+# In der .env Datei von Spoolman auskommentieren:
+SPOOLMAN_DEBUG_MODE=TRUE
+```
+
+Dies ist erforderlich, da Spoolman noch keine CORS-Domain-Konfiguration unterstützt.
+
+---
+
+## Konfiguration
+
+### Waagen-Kalibrierung
+
+1. **Kalibrierung starten**
+ - Gehen Sie zur "Scale" (Waage) Seite
+ - Bereiten Sie ein 500g Referenzgewicht vor (z.B. Wasserglas)
+
+2. **Kalibrierungsschritte**
+ - Folgen Sie den Anweisungen auf dem Display
+ - Legen Sie das Gewicht auf, wenn gefordert
+ - Warten Sie, bis die Kalibrierung abgeschlossen ist
+
+3. **Validierung**
+ - Testen Sie die Genauigkeit mit bekannten Gewichten
+ - Bei Bedarf "Tare Scale" für Nullstellung verwenden
+
+### Spoolman-Verbindung
+
+1. **Spoolman-URL eingeben**
+ - Gehen Sie zur "Spoolman/Bambu" Seite
+ - Geben Sie die vollständige URL Ihrer Spoolman-Instanz ein
+ - Format: `http://spoolman-server:7912`
+
+2. **Verbindung testen**
+ - Das System prüft automatisch die Verbindung
+ - Erfolgreiche Verbindung wird durch grünen Status angezeigt
+
+### Bambu Lab Drucker (optional)
+
+1. **Drucker-Einstellungen**
+ - Öffnen Sie das Einstellungsmenü auf Ihrem Bambu-Drucker
+ - Notieren Sie sich die folgenden Daten:
+ - IP-Adresse des Druckers
+ - Access Code
+ - Serial Number
+
+2. **FilaMan Konfiguration**
+ - Geben Sie die Drucker-Daten in der "Spoolman/Bambu" Seite ein
+ - Aktivieren Sie "Auto Send to Bambu" für automatische AMS-Zuordnung
+
+3. **Auto-Send Timeout**
+ - Konfigurieren Sie die Wartezeit für automatische Spulen-Erkennung
+ - Empfohlener Wert: 10-30 Sekunden
+
+---
+
+## Benutzung
+
+### Grundlegende Bedienung
+
+1. **Filament wiegen**
+ - Platzieren Sie die Spule auf der Waage
+ - Das Gewicht wird automatisch auf dem Display und in der Weboberfläche angezeigt
+
+2. **NFC-Tag scannen**
+ - Halten Sie den Tag in die Nähe des PN532-Moduls
+ - Bei erkannten Tags wird die Spulen-Information angezeigt
+ - Das Gewicht wird automatisch in Spoolman aktualisiert
+
+3. **Status-Überwachung**
+ - **OLED-Display** zeigt aktuelles Gewicht und Verbindungsstatus
+ - **Weboberfläche** bietet detaillierte Informationen und Steuerung
+
+### Weboberfläche Navigation
+
+- **Startseite**: Hauptfunktionen und aktueller Status
+- **Scale**: Waagen-Kalibrierung und -Einstellungen
+- **Spoolman/Bambu**: System-Konfiguration
+- **Statistics**: Nutzungsstatistiken (falls aktiviert)
+
+---
+
+## NFC-Tags
+
+### Unterstützte Tag-Typen
+
+- **NTAG213**: 144 Bytes (grundlegende Funktionen)
+- **NTAG215**: 504 Bytes (empfohlen)
+- **NTAG216**: 888 Bytes (erweiterte Funktionen)
+
+### Tag beschreiben
+
+1. **Spule in Spoolman vorbereiten**
+ - Erstellen Sie eine neue Spule in Spoolman
+ - Stellen Sie sicher, dass alle erforderlichen Daten eingegeben sind
+
+2. **Tag-Beschreibung starten**
+ - Wählen Sie die Spule aus der Liste
+ - Klicken Sie auf "Write Tag"
+ - Das Display zeigt "Waiting for Tag"
+
+3. **Tag auflegen**
+ - Platzieren Sie den NFC-Tag auf dem PN532-Modul
+ - Warten Sie auf die Bestätigung
+
+4. **Erfolgsmeldung**
+ - Bei erfolgreichem Beschreiben wird ein Häkchen angezeigt
+ - Der Tag ist nun mit der Spoolman-Spule verknüpft
+
+### Tag lesen
+
+1. **Tag scannen**
+ - Platzieren Sie die Spule mit dem NFC-Tag auf die Waage über dem NFC-Reader
+ - Bei Problemen beim Lesen: Spule etwas anders positionieren (nicht ganz an den Rand)
+ - Die Spulen-Information wird automatisch geladen
+
+2. **Automatische Updates**
+ - Das aktuelle Gewicht wird in Spoolman übertragen
+ - Die Spule wird in der Weboberfläche automatisch ausgewählt
+
+---
+
+## Bambu Lab Integration
+
+### AMS (Automatic Material System)
+
+1. **AMS-Status anzeigen**
+ - Die Weboberfläche zeigt den aktuellen Zustand aller AMS-Fächer
+ - Beladene Fächer werden mit Filament-Informationen angezeigt
+
+2. **Filament manuell zuordnen**
+ - Wählen Sie eine Spule aus der Spoolman-Liste
+ - Klicken Sie auf das entsprechende AMS-Fach-Symbol
+ - Das Filament wird dem Fach zugeordnet
+
+3. **Automatische Zuordnung**
+ - Nach dem Wiegen mit aktiviertem "Auto Send to Bambu"
+ - Das System wartet auf neue Spulen im AMS
+ - Kalibrierte Filamente werden automatisch zugeordnet
+
+### Bambu Studio Integration
+
+1. **Filament-Profile synchronisieren**
+ - Kalibrieren Sie Filamente in Bambu Studio
+ - Verwenden Sie Device → AMS → Bleistift-Symbol → Auswählen
+
+2. **Setting-IDs speichern**
+ - FilaMan erkennt verfügbare Setting-IDs automatisch
+ - Klicken Sie auf "Settings in Spoolman speichern"
+ - Die Profile werden für zukünftige Drucke verwendet
+
+### Verbindung wiederherstellen
+
+- Bei Verbindungsproblemen klicken Sie den roten Punkt in der Menüleiste
+- Das System stellt automatisch eine neue Verbindung her
+
+---
+
+## Spoolman Integration
+
+### Automatische Funktionen
+
+1. **Spulen-Synchronisation**
+ - Automatische Übertragung von Gewichtsänderungen
+ - Echtzeit-Updates der Spulen-Daten
+
+2. **Extra-Felder**
+ - FilaMan erstellt automatisch erforderliche benutzerdefinierte Felder
+ - NFC-Tag-UID wird als Referenz gespeichert
+
+3. **Filterung**
+ - "Nur Spulen ohne NFC-Tag anzeigen" für einfache Tag-Zuordnung
+ - Kategorisierung nach Herstellern und Materialtypen
+
+### Spoolman Octoprint Plugin
+
+Für Octoprint-Benutzer ist eine automatische Spulen-Zuordnung verfügbar:
+
+1. **Plugin installieren**
+ ```
+ https://github.com/ManuelW77/OctoPrint-Spoolman-Filaman/archive/refs/heads/master.zip
+ ```
+
+2. **FilaMan konfigurieren**
+ - Aktivieren Sie "Send to Octo-Plugin"
+ - Geben Sie Octoprint-URL und API-Key ein
+
+3. **Automatische Zuordnung**
+ - Nach dem Wiegen wird die Spule automatisch in Octoprint aktiviert
+ - Unterstützt aktuell nur Tool0 (erste Düse)
+
+---
+
+## Hersteller Tags
+
+### Überblick
+
+Hersteller Tags ermöglichen es Filament-Produzenten, vorkonfigurierte NFC-Tags zu liefern, die automatisch alle notwendigen Einträge in Spoolman erstellen.
+
+### Erste Schritte mit Hersteller Tags
+
+1. **Tag scannen**
+ - Platzieren Sie die Spule mit dem Hersteller-Tag auf die Waage über dem NFC-Reader
+ - Bei Problemen beim Lesen: Spule etwas anders positionieren (nicht ganz an den Rand)
+ - Das System erkennt automatisch das Hersteller-Format
+
+2. **Automatische Erstellung**
+ - **Marke** wird in Spoolman angelegt (falls nicht vorhanden)
+ - **Filament-Typ** wird mit allen Spezifikationen erstellt
+ - **Spule** wird automatisch registriert
+
+3. **Zukünftige Scans**
+ - Nach der ersten Einrichtung nutzen Tags das Fast-Path-System
+ - Sofortige Gewichtsmessung ohne erneute Einrichtung
+
+### Unterstützte Hersteller
+
+- **RecyclingFabrik**: Erster offizieller Partner
+- Weitere Hersteller folgen
+
+### Vorteile
+
+- ✅ **Null manuelle Einrichtung**
+- ✅ **Perfekte Datengenauigkeit**
+- ✅ **Sofortige Integration**
+- ✅ **Zukunftssicher**
+
+---
+
+## Fehlerbehebung
+
+### Häufige Probleme
+
+#### WiFi-Verbindung
+
+**Problem**: Kann nicht mit FilaMan-Hotspot verbinden
+- Lösung: Stellen Sie sicher, dass der ESP32 gestartet ist
+- Alternative: Manuell zu http://192.168.4.1 navigieren
+
+**Problem**: Weboberfläche nicht erreichbar
+- Lösung: Prüfen Sie die IP-Adresse im Router
+- Alternative: Verwenden Sie http://filaman.local
+
+#### Waage
+
+**Problem**: Ungenaue Gewichtsmessungen
+- Lösung: Kalibrierung wiederholen
+- Tipp: Verwenden Sie "Tare Scale" für Nullstellung
+
+**Problem**: Wägezelle reagiert nicht
+- Lösung: Überprüfen Sie die Verkabelung (E+, E-, A+, A-)
+- Tipp: Testen Sie mit einem Multimeter
+
+#### NFC-Tags
+
+**Problem**: Tag wird nicht erkannt
+- Lösung: Überprüfen Sie die PN532 DIP-Schalter (I2C-Modus)
+- Tipp: Spule etwas anders auf der Waage positionieren (nicht ganz an den Rand)
+
+**Problem**: Tag kann nicht beschrieben werden
+- Lösung: Verwenden Sie NTAG215 für bessere Kompatibilität
+- Tipp: Stellen Sie sicher, dass der Tag nicht schreibgeschützt ist
+
+#### Spoolman
+
+**Problem**: Verbindung zu Spoolman schlägt fehl
+- Lösung: Aktivieren Sie SPOOLMAN_DEBUG_MODE=TRUE
+- Tipp: Überprüfen Sie die URL-Formatierung
+
+**Problem**: Spulen werden nicht angezeigt
+- Lösung: Stellen Sie sicher, dass Spoolman läuft
+- Tipp: Prüfen Sie die Netzwerk-Firewall-Einstellungen
+
+#### Bambu Lab
+
+**Problem**: Drucker verbindet nicht
+- Lösung: Überprüfen Sie Access Code und IP-Adresse
+- Tipp: Stellen Sie sicher, dass der Drucker im LAN-Modus ist
+
+**Problem**: AMS-Status wird nicht angezeigt
+- Lösung: Prüfen Sie die MQTT-Verbindung
+- Hinweis: Bambu kann die API jederzeit schließen
+
+### Debug-Informationen
+
+Falls Sie Probleme haben, können Sie diese Schritte zur Diagnose verwenden:
+
+#### Serieller Monitor (für Entwickler)
+- Verbinden Sie den ESP32 über USB mit Ihrem Computer
+- Öffnen Sie einen seriellen Monitor (z.B. Arduino IDE) mit 115200 Baud
+- Sie sehen detaillierte Log-Nachrichten des Systems
+
+#### Browser-Konsole
+- Öffnen Sie die Weboberfläche von FilaMan
+- Drücken Sie F12 um die Entwicklertools zu öffnen
+- Schauen Sie in der Konsole nach Fehlermeldungen
+
+#### Neustart bei anhaltenden Problemen
+1. ESP32 vom Strom trennen
+2. 10 Sekunden warten
+3. Wieder anschließen
+4. 30 Sekunden für vollständigen Start warten
+
+---
+
+## Support
+
+### Community
+
+- **Discord Server**: [https://discord.gg/my7Gvaxj2v](https://discord.gg/my7Gvaxj2v)
+- **GitHub Issues**: [Filaman Repository](https://github.com/ManuelW77/Filaman/issues)
+- **YouTube Kanal**: [Deutsches Erklärvideo](https://youtu.be/uNDe2wh9SS8?si=b-jYx4I1w62zaOHU)
+
+### Dokumentation
+
+- **Offizielle Website**: [www.filaman.app](https://www.filaman.app)
+- **GitHub Wiki**: [Detaillierte Dokumentation](https://github.com/ManuelW77/Filaman/wiki)
+- **Hardware-Referenz**: ESP32 Pinout-Diagramme in `/img/`
+
+### Entwicklung unterstützen
+
+Wenn Sie das Projekt unterstützen möchten:
+
+[](https://www.buymeacoffee.com/manuelw)
+
+### Lizenz
+
+Dieses Projekt ist unter der MIT-Lizenz veröffentlicht. Siehe [LICENSE](LICENSE.txt) für Details.
+
+---
+
+**Letzte Aktualisierung**: August 2025
+**Version**: 2.0
+**Maintainer**: Manuel W.
\ No newline at end of file
diff --git a/WIKI_EN.md b/WIKI_EN.md
new file mode 100644
index 0000000..5cee6e4
--- /dev/null
+++ b/WIKI_EN.md
@@ -0,0 +1,746 @@
+# FilaMan Wiki - English
+
+## Table of Contents
+
+1. [Overview](#overview)
+2. [Installation](#installation)
+3. [Hardware Requirements](#hardware-requirements)
+4. [Initial Setup](#initial-setup)
+5. [Configuration](#configuration)
+6. [Usage](#usage)
+7. [NFC Tags](#nfc-tags)
+8. [Bambu Lab Integration](#bambu-lab-integration)
+9. [Spoolman Integration](#spoolman-integration)
+10. [Octoprint Integration](#octoprint-integration)
+11. [Manufacturer Tags](#manufacturer-tags)
+12. [Troubleshooting](#troubleshooting)
+13. [Support](#support)
+
+---
+
+## Overview
+
+FilaMan is a comprehensive filament management system for 3D printers based on ESP32 hardware. It provides weight measurement, NFC tag management, and seamless integration with Spoolman and Bambu Lab 3D printers.
+
+### Key Features
+
+- **Precise weight measurement** with HX711 load cell amplifier
+- **NFC tag reading and writing** for filament identification
+- **OLED display** for status information
+- **WiFi connectivity** with easy configuration
+- **Web-based user interface** with real-time updates
+- **Spoolman integration** for inventory management
+- **Bambu Lab AMS control** via MQTT
+- **OpenSpool NFC format** compatibility
+- **Manufacturer tag support** for automatic setup
+
+### System Requirements
+
+- **ESP32 Development Board**
+- **Spoolman Instance** (required for full functionality)
+- **WiFi Network**
+- **Web Browser** (Chrome/Firefox/Safari)
+
+---
+
+## Installation
+
+### Easy Installation (Recommended)
+
+1. **Open the [FilaMan Web Installer](https://www.filaman.app/installer.html)**
+ - Use a Chrome-based browser
+
+2. **Prepare ESP32**
+ - Connect ESP32 via USB to your computer
+ - Click "Connect"
+
+3. **Select Port**
+ - Choose the appropriate USB port
+ - Confirm selection
+
+4. **Start Installation**
+ - Click "Install FilaMan"
+ - Wait for installation to complete
+
+### Manual Compilation
+
+For advanced users with PlatformIO:
+
+```bash
+git clone https://github.com/ManuelW77/Filaman.git
+cd FilaMan/esp32
+pio lib install
+pio run --target upload
+```
+
+---
+
+## Hardware Requirements
+
+### Required Components
+
+| Component | Description | Amazon Link (Affiliate) |
+|-----------|-------------|-------------------------|
+| ESP32 Development Board | Any ESP32 variant | [Amazon](https://amzn.to/3FHea6D) |
+| HX711 + Load Cell | 5kg Load Cell Amplifier | [Amazon](https://amzn.to/4ja1KTe) |
+| OLED Display | 0.96" I2C 128x64 SSD1306 | [Amazon](https://amzn.to/445aaa9) |
+| PN532 NFC Module | V3 RFID Module | [Amazon](https://amzn.eu/d/gy9vaBX) |
+| NFC Tags | NTAG213/NTAG215 | [Amazon](https://amzn.to/3E071xO) |
+| TTP223 Touch Sensor | Optional for tare function | [Amazon](https://amzn.to/4hTChMK) |
+
+### Pin Configuration
+
+| Component | ESP32 Pin | Function |
+|-----------|-----------|----------|
+| HX711 DOUT | 16 | Load cell data output |
+| HX711 SCK | 17 | Load cell clock |
+| OLED SDA | 21 | I2C data |
+| OLED SCL | 22 | I2C clock |
+| PN532 IRQ | 32 | Interrupt |
+| PN532 RESET | 33 | Reset |
+| PN532 SDA | 21 | I2C data (shared) |
+| PN532 SCL | 22 | I2C clock (shared) |
+| TTP223 I/O | 25 | Touch sensor (optional) |
+
+### Important Notes
+
+- **PN532 DIP switches** must be set to I2C mode
+- **3V pin** from ESP32 for touch sensor
+- **Load cell wiring**: E+ (red), E- (black), A- (white), A+ (green)
+
+
+
+---
+
+## Initial Setup
+
+### After Installation
+
+1. **ESP32 Restart**
+ - System automatically creates a WiFi hotspot "FilaMan"
+
+2. **WiFi Configuration**
+ - Connect to the "FilaMan" network
+ - Open browser (automatic portal or