spooly.eu/docs/home-assistant/entities

Entities

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

On this page

Your names look differentThe 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.