From 4c1d0534dfecae9cadfdd8e99238c120d3c638d4 Mon Sep 17 00:00:00 2001 From: Robert Resch Date: Mon, 26 May 2025 16:58:41 +0200 Subject: [PATCH] Deprecate cups integration (#39244) --- source/_integrations/cups.markdown | 80 ------------------------------ source/_redirects | 1 + 2 files changed, 1 insertion(+), 80 deletions(-) delete mode 100644 source/_integrations/cups.markdown diff --git a/source/_integrations/cups.markdown b/source/_integrations/cups.markdown deleted file mode 100644 index 9439839d4d5..00000000000 --- a/source/_integrations/cups.markdown +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: CUPS -description: Instructions on how to integrate CUPS sensors into Home Assistant. -ha_category: - - System monitor -ha_iot_class: Local Polling -ha_release: 0.32 -ha_codeowners: - - '@fabaff' -ha_domain: cups -ha_platforms: - - sensor -ha_integration_type: integration -related: - - docs: /docs/configuration/ - title: Configuration file -ha_quality_scale: legacy ---- - -The `cups` sensor platform uses the open source printing system [CUPS](https://www.cups.org/) to show details about your printers, including the ink levels. It can obtain the information using a CUPS server or by 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` or`cups-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 {% term "`configuration.yaml`" %} file. -{% include integrations/restart_ha_after_config_inclusion.md %} - -```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 your "Printer Name" here. - 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: - -```yaml -# Example configuration.yaml entry for an IPP printer -sensor: - - platform: cups - host: PRINTER_IP - is_cups_server: false - printers: - - ipp/print -``` diff --git a/source/_redirects b/source/_redirects index a6d8130ab30..1647c4ff8b3 100644 --- a/source/_redirects +++ b/source/_redirects @@ -530,6 +530,7 @@ layout: null /integrations/coinmarketcap /more-info/removed-integration 301 /integrations/coronavirus /more-info/removed-integration 301 /integrations/crimereports /more-info/removed-integration 301 +/integrations/cups /more-info/removed-integration 301 /integrations/darksky /more-info/removed-integration 301 /integrations/deutsche_bahn /more-info/removed-integration 301 /integrations/device_tracker.trackr /more-info/removed-integration 301