Source: https://spooly.eu/en/docs/home-assistant/entities

# Entities

The integration creates a device per spool and per printer, plus the Spooly device for your account.

> Your names look different: The names depend on the language of your Home Assistant instance and on your spool and printer names, for maintenance tasks also on the language of your Spooly account. The examples come from an English instance with the spool #1 Jade White and the printer X1 Carbon von Tobi. You find your own under Settings, Devices & services, Entities.

## Per spool

The device is named after the spool, with number and name, for example `#1 Jade White`. Without a number, only the name appears.

| Entity | State | Attributes |
| --- | --- | --- |
| Remaining weight `sensor.1_jade_white_remaining_weight` | Remaining amount in grams | `manufacturer` `material` `finish` `color` `color_name` `location` `location_id` `place` `spool_size_grams` `empty_spool_grams` `fill_percent` |
| Low `binary_sensor.1_jade_white_low` | On when Spooly reports the spool as low or critical. Home Assistant then shows “Problem”. You set the thresholds in Spooly. The integration calculates nothing itself. | `level`: `low` or `crit` |

## Per printer

| Entity | State | Attributes |
| --- | --- | --- |
| One sensor per slot, named like the slot `sensor.x1_carbon_von_tobi_1_2` | Name of the spool in the slot, “unknown” for an empty slot | `spool_id` `number` `material` `color` `slot_id` only with an active slot autopilot |
| Due maintenance `sensor.x1_carbon_von_tobi_due_maintenance` | Number of due tasks | `soon_count`: due soon |
| Print hours `sensor.x1_carbon_von_tobi_print_hours` | Hours | none |
| One sensor per maintenance task, named like the task `sensor.x1_carbon_von_tobi_nozzle_0_4_mm` | Due, Soon or OK. In automations `due`, `soon` or `ok`. | `metric` `interval` `used` `remaining` `eta_days` `last_done_at` `snoozed_until` `default_action` |

## On the Spooly device

| Entity | State | Attributes |
| --- | --- | --- |
| Filament this month `sensor.spooly_filament_this_month` | Grams in the calendar month of your Home Assistant time, back to 0 at the start of the month | none |
| Stock value `sensor.spooly_stock_value` | In your currency | none |
| Calls today `sensor.spooly_calls_today` | Calls made today. Diagnostic, disabled by default. | `daily_limit` `account` |

## History and statistics

Remaining weight, due maintenance and calls today are measurements, print hours and filament this month are increasing totals. Home Assistant keeps long-term statistics for these five, so you can show them in statistics graphs. Stock value has none.