home-assistant.io/source/_components/sensor.octoprint.markdown
Klaas Schoute e4bd4fb05d Update Octoprint component configuration (#6909)
* Update Octoprint component configuration

* Add period
2018-10-17 23:53:29 +02:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page OctoPrint Sensor Instructions on how to integrate OctoPrint sensors within Home Assistant. 2016-05-05 08:00 true false true true octoprint.png Sensor 0.19 Local Polling

The octoprint sensor platform let you monitor various states of your 3D printer and its print jobs.

You must have the [OctoPrint component](/components/octoprint/) configured to use this sensor.

To set it up, add the following information to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: octoprint
    name: OctoPrint
    monitored_conditions:
      - Current State
      - Temperatures
      - Job Percentage
      - Time Elapsed
      - Time Remaining

{% configuration %} name: description: The name of the sensor. required: false default: OctoPrint type: string monitored_conditions: description: States to monitor. required: true type: list keys: current state: description: Text of current state. temperatures: description: Temperatures of all available tools, e.g., print, head, print bed, etc. These will be displayed as tool0, tool1, or toolN please refer to your OctoPrint frontend to associate the tool number with an actual device. job percentage: description: Percentage of the job. time elapsed: description: Time elapsed on current print job, in seconds. time remaining: description: Time remaining on current print job, in seconds. {% endconfiguration %}

If you are tracking temperature it is recommended to set `bed` and/or `number_of_tools` in your octoprint configuration. This will allow the octoprint sensors to load if the printer is offline during Home Assistant startup.