jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-17 00:18:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/cups.markdown

2.5 KiB
Raw Blame History

title, description, logo, ha_category, ha_iot_class, ha_release, ha_codeowners
title description logo ha_category ha_iot_class ha_release ha_codeowners
CUPS Instructions on how to integrate CUPS sensors into Home Assistant. cups.png
System Monitor
Local Polling 0.32
@fabaff

The cups sensor platform is using the open source printing system CUPS to show details about your printers, including the ink levels. It can obtain the informations using a CUPS server or communicating directly with the printer with the Internet Printing Protocol.

Setup

You will need to install the python3-dev or python3-devel package and the development files for CUPS (libcups2-dev orcups-devel) on your system manually (e.g., sudo apt-get install python3-dev libcups2-dev or sudo dnf -y install python3-devel cups-devel) along with a compiler (gcc). This integration doesn't work out-of-the-box in a container-based setup.

To set up the sensor the "Queue Name" of the printer is needed. The fastest way to get it, is to visit the CUPS web interface at "http://[IP ADDRESS PRINT SERVER]:631" and go to "Printers".

Configuration

To enable the CUPS sensor, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
sensor:
  - platform: cups
    printers:
      - C410
      - C430

{% configuration %} printers: description: List of printers to add. If you're not using a CUPS server, add here your "Printer Name". required: true type: list host: description: The IP address of the CUPS print server or of the printer. required: false type: string default: 127.0.0.1 port: description: The port number of the CUPS print server or of the printer. required: false type: integer default: 631 is_cups_server: description: Set true if you want to use a CUPS print server, set false otherwise. required: false type: boolean default: true {% endconfiguration %}

Examples

Default configuration for an IPP printer:

# Example configuration.yaml entry for an IPP printer
sensor:
  - platform: cups
    host: PRINTER_IP
    is_cups_server: false
    printers:
      - ipp/print

You will need to install the python3-dev or python3-devel and the development files for CUPS (libcups2-dev orcups-devel) package on your system manually (eg. sudo apt-get install python3-dev libcups2-dev or sudo dnf -y install python3-devel cups-devel) along with a compiler (gcc).