Quelle: https://spooly.eu/docs/home-assistant/entities

# Entitäten

Die Integration legt je Spule und je Drucker ein Gerät an, dazu das Gerät Spooly für dein Konto.

> Deine Namen sehen anders aus: Die Namen hängen von der Sprache deiner Home-Assistant-Instanz und von deinen Spulen- und Druckernamen ab, bei Wartungsaufgaben auch von der Sprache deines Spooly-Kontos. Die Beispiele stammen von einer englischen Instanz mit der Spule #1 Jade White und dem Drucker X1 Carbon von Tobi. Deine eigenen findest du unter Einstellungen, Geräte & Dienste, Entitäten.

## Je Spule

Das Gerät heißt wie die Spule, mit Nummer und Name, zum Beispiel `#1 Jade White`. Ohne Nummer steht nur der Name.

| Entität | Zustand | Attribute |
| --- | --- | --- |
| Remaining weight, deutsch Restgewicht `sensor.1_jade_white_remaining_weight` | Restmenge in Gramm | `manufacturer` `material` `finish` `color` `color_name` `location` `location_id` `place` `spool_size_grams` `empty_spool_grams` `fill_percent` |
| Low, deutsch Niedrig (Binärsensor) `binary_sensor.1_jade_white_low` | An, wenn Spooly die Spule als niedrig oder kritisch meldet. Home Assistant zeigt dann „Problem“. Die Schwellen stellst du in Spooly ein. Die Integration rechnet nichts selbst. | `level`: `low` oder `crit` |

## Je Drucker

| Entität | Zustand | Attribute |
| --- | --- | --- |
| Ein Sensor je Slot, er heißt wie der Slot `sensor.x1_carbon_von_tobi_1_2` | Name der Spule im Slot, bei leerem Slot „unbekannt“ | `spool_id` `number` `material` `color` `slot_id` nur mit aktivem Slot-Autopilot |
| Due maintenance, deutsch Fällige Wartungen `sensor.x1_carbon_von_tobi_due_maintenance` | Anzahl der fälligen Aufgaben | `soon_count`: bald fällig |
| Print hours, deutsch Druckstunden `sensor.x1_carbon_von_tobi_print_hours` | Stunden | keine |
| Ein Sensor je Wartungsaufgabe, er heißt wie die Aufgabe `sensor.x1_carbon_von_tobi_nozzle_0_4_mm` | Fällig, Bald oder OK. In Automationen `due`, `soon` oder `ok`. | `metric` `interval` `used` `remaining` `eta_days` `last_done_at` `snoozed_until` `default_action` |

## Am Gerät Spooly

| Entität | Zustand | Attribute |
| --- | --- | --- |
| Filament this month, deutsch Filament diesen Monat `sensor.spooly_filament_this_month` | Gramm im Kalendermonat deiner Home-Assistant-Zeit, am Monatsanfang wieder 0 | keine |
| Stock value, deutsch Lagerwert `sensor.spooly_stock_value` | In deiner Währung | keine |
| Calls today, deutsch Aufrufe heute `sensor.spooly_calls_today` | Aufrufe von heute. Diagnose, standardmäßig deaktiviert. | `daily_limit` `account` |

## Verlauf und Statistik

Restgewicht, fällige Wartungen und Aufrufe heute sind Messwerte, Druckstunden und Filament diesen Monat steigende Summen. Für diese fünf speichert Home Assistant Langzeitstatistik, du kannst sie also in Statistik-Diagrammen zeigen. Der Lagerwert hat keine.
