# FilaMan – Filament Management System

---

## 🇩🇪 Deutsch

**FilaMan** ist eine webbasierte Open-Source-Anwendung zur Verwaltung von **3D-Drucker-Filamenten**. Sie ermöglicht es Einzelpersonen und Teams, ihren gesamten Filamentbestand zentral zu erfassen, zu organisieren und zu überwachen.

### Funktionsumfang

- **Spulenverwaltung** – Erfassen Sie jede Filamentspule mit Gewicht, Status und Lagerort
- **Füllstandsüberwachung** – Automatische Statusberechnung (Full / Normal / Low / Critical / Empty) mit Low-Stock-Warnungen auf dem Dashboard
- **Hersteller & Filamente** – Strukturierte Verwaltung von Herstellern und Filamentprodukten mit Materialtyp, Durchmesser und Farben
- **Lagerorte** – Definition von Lagerplätzen mit optionaler RFID-Integration zur automatischen Identifikation
- **Druckerintegration** – Anbindung von 3D-Druckern über OctoPrint oder Klipper/Moonraker zur automatischen Verbrauchserfassung
- **Mehrbenutzer & Rollen** – Rollenbasierte Zugriffskontrolle (Administrator, User, Viewer) mit individuell konfigurierbaren Berechtigungen
- **API & Geräte-Token** – REST-API für externe Geräte und Automatisierungen (z. B. RFID-Scanner)
- **Zusatzfelder** – Erweiterbare Datenfelder für Spulen und Filamente nach eigenen Anforderungen
- **Mehrsprachig** – Unterstützung mehrerer Anzeigesprachen

### Github
https://github.com/Fire-Devils/filaman-system

https://github.com/Fire-Devils/FilaMan-System-ESP32

https://github.com/Fire-Devils/filaman-plugins

### Dokumentation

📖 **[Zum deutschen Endanwender-Handbuch](docs/de/00-inhalt)**

---

## 🇬🇧 English

**FilaMan** is a web-based open-source application for managing **3D printer filaments**. It enables individuals and teams to centrally record, organize, and monitor their entire filament inventory.

### Features

- **Spool management** – Track every filament spool with weight, status, and storage location
- **Fill level monitoring** – Automatic status calculation (Full / Normal / Low / Critical / Empty) with low-stock alerts on the Dashboard
- **Manufacturers & Filaments** – Structured management of manufacturers and filament products including material type, diameter, and colors
- **Storage locations** – Define storage places with optional RFID integration for automatic identification
- **Printer integration** – Connect 3D printers via OctoPrint or Klipper/Moonraker for automatic consumption tracking
- **Multi-user & roles** – Role-based access control (Administrator, User, Viewer) with individually configurable permissions
- **API & device tokens** – REST API for external devices and automations (e.g. RFID scanners)
- **Extra fields** – Extensible data fields for spools and filaments tailored to your needs
- **Multi-language** – Support for multiple display languages

### Github
https://github.com/Fire-Devils/filaman-system

https://github.com/Fire-Devils/FilaMan-System-ESP32

https://github.com/Fire-Devils/filaman-plugins

### Documentation

📖 **[Go to the English User Manual](docs/en/00-contents)**

---

*FilaMan is developed and maintained by Manuel Weiser. Licensed under the MIT License.*
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9