@homebridge-plugins/homebridge-printer 0.0.0-stage → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Change Log
+
+All notable changes to `@homebridge-plugins/homebridge-printer` will be documented in this file.
+
+## v1.0.0 (Pending Release)
+
+### Added
+
+- First release, from @Wazza151's rewrite of SeydX's homebridge-printer, which works on Homebridge 2
+- A Printing switch, an Online switch, and a printing sensor with fault status
+- One tile per ink or toner cartridge, with a low-ink alert, and Eve print history
+- Estimated watts and kWh over Matter, or everything over Matter only
+- A live dashboard on the settings page and at port 8587, and a search for printers on the network

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2020 Seyd
+Copyright (c) 2026 homebridge-plugins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,63 @@
-# Temporary Holding Version
+<p align="center">
+   <a href="https://github.com/homebridge-plugins/homebridge-printer"><img alt="homebridge-printer" src="https://raw.githubusercontent.com/homebridge-plugins/homebridge-printer/latest/branding/Homebridge_x_Printer.png" width="600px"></a>
+</p>
+<span align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## homebridge-printer
+
+Homebridge plugin to show HP and other AirPrint printers in Apple Home, with ink levels and a live dashboard
+
+[![npm](https://img.shields.io/npm/v/@homebridge-plugins/homebridge-printer/latest?label=latest)](https://www.npmjs.com/package/@homebridge-plugins/homebridge-printer)
+[![npm](https://img.shields.io/npm/v/@homebridge-plugins/homebridge-printer/beta?label=beta)](https://github.com/homebridge-plugins/homebridge-printer/wiki/Beta-Version)<br>
+[![npm](https://img.shields.io/npm/dt/@homebridge-plugins/homebridge-printer)](https://www.npmjs.com/package/@homebridge-plugins/homebridge-printer)
+[![Discord](https://img.shields.io/discord/432663330281226270?color=728ED5&logo=discord&label=hb-discord)](https://discord.gg/bHjKNkN)
+
+</span>
+
+### Plugin Information
+
+- This plugin shows your network printers in Apple Home. It was made for HP printers, and works with most printers that support AirPrint (IPP). The plugin:
+  - reads the printer locally over IPP - no account or cloud needed
+  - shows a **Printing** switch that is on only while a job is printing, and an **Online** switch that is on while the printer is reachable
+  - shows one tile per ink or toner cartridge, with a low-ink alert
+  - adds Eve app print history
+  - can show **estimated watts and kWh** for the printer, over Matter (Homebridge `v2.3` or above)
+  - adds a live dashboard of ink levels and status, on the plugin's settings page and at `http://<homebridge>:8587/`
+- It replaces [homebridge-printer](https://www.npmjs.com/package/homebridge-printer) by SeydX, which no longer works with Homebridge `v2` - see [Coming from homebridge-printer](https://github.com/homebridge-plugins/homebridge-printer/wiki/Coming-From-Homebridge-Printer).
+
+### Prerequisites
+
+- To use this plugin, you will need to already have:
+  - [Node](https://nodejs.org): latest version of `v22`, `v24` or `v26` - any other major version is not supported.
+  - [Homebridge](https://homebridge.io): `v1.11.4` or above, or `v2` - refer to link for more information and installation instructions.
+  - For estimated watts in the Home app: Homebridge `v2.3` or above with Matter turned on, and iOS `27` or above.
+
+### Setup
+
+- [Installation](https://github.com/homebridge-plugins/homebridge-printer/wiki/Installation)
+- [Configuration](https://github.com/homebridge-plugins/homebridge-printer/wiki/Configuration)
+- [Beta Version](https://github.com/homebridge-plugins/homebridge-printer/wiki/Beta-Version)
+- [Node Version](https://github.com/homebridge-plugins/homebridge-printer/wiki/Node-Version)
+
+### Features
+
+- [Supported Printers](https://github.com/homebridge-plugins/homebridge-printer/wiki/Supported-Printers)
+- [Energy and Matter](https://github.com/homebridge-plugins/homebridge-printer/wiki/Energy-and-Matter)
+- [Dashboard](https://github.com/homebridge-plugins/homebridge-printer/wiki/Dashboard)
+
+### Help/About
+
+- [Common Errors](https://github.com/homebridge-plugins/homebridge-printer/wiki/Common-Errors)
+- [Support Request](https://github.com/homebridge-plugins/homebridge-printer/issues/new/choose)
+- [Changelog](https://github.com/homebridge-plugins/homebridge-printer/blob/latest/CHANGELOG.md)
+
+### Credits
+
+- To [@Wazza151](https://github.com/Wazza151): the creator of this version of the plugin.
+- To [@SeydX](https://github.com/SeydX): the creator of [homebridge-printer](https://github.com/SeydX/homebridge-printer), which this plugin is based on.
+- To the creators/contributors of [Homebridge](https://homebridge.io) who make this plugin possible.
+
+### Disclaimer
+
+- I am in no way affiliated with HP or any other printer maker and this plugin is a personal project that I maintain in my free time.
+- Use this plugin entirely at your own risk - please see licence for more information.

package/branding/Homebridge_x_Printer.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="600" height="220" viewBox="0 0 600 220"><image width="600" height="220" xlink:href="data:image/png;base64,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"/></svg>

package/config.schema.json

@@ -0,0 +1,250 @@
+{
+  "pluginAlias": "Printer",
+  "pluginType": "platform",
+  "singular": true,
+  "customUi": true,
+  "customUiPath": "./lib/homebridge-ui",
+  "headerDisplay": "<p align=\"center\"><img width=\"250px\" src=\"https://raw.githubusercontent.com/homebridge-plugins/homebridge-printer/latest/branding/Homebridge_x_Printer.png\"></p><p align=\"center\">For help and support please visit our <a href=\"https://github.com/homebridge-plugins/homebridge-printer/wiki\">GitHub Wiki</a>. We hope you find this plugin useful!</p>\n\n**Enter your printer's IP address or .local name below, click Save, then restart Homebridge.**\n\nNot sure of the address? Print the printer's *Network Configuration* page, look in HP Smart under *Printer Settings → Network Information*, or run `ippfind` in Terminal on a Mac.\n\nAfter restarting, ink levels and printer status are shown at [http://${{HOSTNAME}}:8587](http://${{HOSTNAME}}:8587) (or the port set under *Dashboard web page*).",
+  "footerDisplay": "Each printer appears in the Home app as a **Printer** accessory (printing sensor and one tile per ink cartridge), plus the **Printer Online** and **Printer Printing** switches if they're turned on above.",
+  "schema": {
+    "type": "object",
+    "required": [
+      "name"
+    ],
+    "properties": {
+      "name": {
+        "title": "Plugin name (shown in the log)",
+        "type": "string",
+        "default": "Printer"
+      },
+      "printers": {
+        "title": "Printers",
+        "type": "array",
+        "minItems": 1,
+        "items": {
+          "type": "object",
+          "title": "Printer",
+          "properties": {
+            "address": {
+              "title": "Printer IP address or .local name",
+              "type": "string",
+              "placeholder": "192.168.1.20  or  HP7A1B2C.local",
+              "description": "Just the IP or name is enough. A full address such as ipp://192.168.1.20/ipp/print also works."
+            },
+            "name": {
+              "title": "Name in the Home app (optional)",
+              "type": "string",
+              "placeholder": "Printer",
+              "description": "The switches are called \"(printer name) Online\" and \"(printer name) Printing\" (default \"Printer Online\" / \"Printer Printing\")."
+            },
+            "onlineSwitch": {
+              "title": "Show a \"Printer Online\" switch (on while the printer is switched on)",
+              "type": "boolean",
+              "default": true,
+              "description": "With Matter turned on, this is an outlet that also shows the printer's energy use."
+            },
+            "printingSwitch": {
+              "title": "Switch 2: \"Printer Printing\" – on only while printing",
+              "type": "boolean",
+              "default": true
+            },
+            "lowInkThreshold": {
+              "title": "Warn when ink is below (%)",
+              "type": "integer",
+              "default": 10,
+              "minimum": 0,
+              "maximum": 99
+            },
+            "polling": {
+              "title": "Check the printer every (seconds)",
+              "type": "integer",
+              "default": 5,
+              "minimum": 2,
+              "maximum": 3600,
+              "description": "How quickly the switches react. 5 seconds catches even short one-page prints."
+            },
+            "marker": {
+              "title": "Show ink levels in the Home app",
+              "type": "boolean",
+              "default": true
+            },
+            "history": {
+              "title": "Printing history in the Eve app",
+              "type": "boolean",
+              "default": true
+            },
+            "manufacturer": {
+              "title": "Manufacturer",
+              "type": "string",
+              "placeholder": "HP"
+            },
+            "model": {
+              "title": "Model",
+              "type": "string",
+              "placeholder": "Detected automatically"
+            },
+            "serialNumber": {
+              "title": "Serial number",
+              "type": "string"
+            },
+            "energy": {
+              "title": "Energy in Apple Home",
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "title": "Show energy use in Apple Home",
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Needs Homebridge 2.3 or newer with Matter turned on (Homebridge UI → Settings → Matter Settings), and iOS 27 for the Home app's Electricity view. Printers don't report their power use, so it's worked out from what the printer is doing and the wattages below. When Switch 1 is on, the energy is shown on the \"Printer Online\" outlet."
+                },
+                "printingWatts": {
+                  "title": "Watts while printing",
+                  "type": "number",
+                  "default": 10,
+                  "minimum": 0,
+                  "maximum": 2000,
+                  "description": "Not published by HP; 10 W is a guess for a small inkjet. A plug meter gives the real figure."
+                },
+                "readyWatts": {
+                  "title": "Watts when ready (idle)",
+                  "type": "number",
+                  "default": 2.8,
+                  "minimum": 0,
+                  "maximum": 500
+                },
+                "sleepWatts": {
+                  "title": "Watts when asleep",
+                  "type": "number",
+                  "default": 1.4,
+                  "minimum": 0,
+                  "maximum": 500
+                },
+                "offWatts": {
+                  "title": "Watts when off or not reachable",
+                  "type": "number",
+                  "default": 0.3,
+                  "minimum": 0,
+                  "maximum": 500
+                },
+                "sleepAfterMinutes": {
+                  "title": "Printer goes to sleep after (minutes idle)",
+                  "type": "integer",
+                  "default": 5,
+                  "minimum": 0,
+                  "maximum": 240
+                }
+              }
+            }
+          },
+          "required": [
+            "address"
+          ]
+        }
+      },
+      "matterOnly": {
+        "title": "Matter only (no HomeKit accessories)",
+        "type": "boolean",
+        "default": false,
+        "description": "Publish the printer to Apple Home over Matter only: Switch 1 \"Printer Online\" (with energy use) and Switch 2 \"Printer Printing\" become Matter outlets, and the HomeKit accessories from this plugin are removed. Apple Home has no Matter tile for ink, so ink levels are shown on the dashboard only. Needs Homebridge 2.3 or newer with Matter turned on (Settings → Matter Settings) and the Matter bridge added to the Home app; until then the HomeKit accessories are kept."
+      },
+      "dashboard": {
+        "title": "Dashboard web page",
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "title": "Show the ink & status dashboard web page",
+            "type": "boolean",
+            "default": true
+          },
+          "port": {
+            "title": "Dashboard port",
+            "type": "integer",
+            "default": 8587,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Open http://(your Homebridge address):(this port)/ in any browser."
+          }
+        }
+      },
+      "debug": {
+        "title": "Debug logging",
+        "type": "boolean",
+        "default": false
+      }
+    }
+  },
+  "layout": [
+    {
+      "key": "printers",
+      "type": "array",
+      "title": "Printers",
+      "orderable": false,
+      "buttonText": "Add another printer",
+      "items": [
+        "printers[].address",
+        "printers[].name",
+        "printers[].onlineSwitch",
+        "printers[].printingSwitch",
+        {
+          "type": "fieldset",
+          "title": "More options",
+          "expandable": true,
+          "expanded": false,
+          "items": [
+            "printers[].lowInkThreshold",
+            "printers[].polling",
+            "printers[].marker",
+            "printers[].history",
+            "printers[].manufacturer",
+            "printers[].model",
+            "printers[].serialNumber"
+          ]
+        },
+        {
+          "type": "fieldset",
+          "title": "Energy in Apple Home",
+          "expandable": true,
+          "expanded": false,
+          "description": "Defaults are HP's figures for the DeskJet 2800 series (ready 2.8 W, sleep 1.4 W, off 0.3 W). Change them for other printers.",
+          "items": [
+            "printers[].energy.enabled",
+            "printers[].energy.printingWatts",
+            "printers[].energy.readyWatts",
+            "printers[].energy.sleepWatts",
+            "printers[].energy.offWatts",
+            "printers[].energy.sleepAfterMinutes"
+          ]
+        }
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Apple Home connection",
+      "expandable": true,
+      "expanded": true,
+      "items": [
+        "matterOnly"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Dashboard web page",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "dashboard.enabled",
+        "dashboard.port"
+      ]
+    },
+    {
+      "type": "fieldset",
+      "title": "Advanced",
+      "expandable": true,
+      "expanded": false,
+      "items": [
+        "name",
+        "debug"
+      ]
+    }
+  ]
+}

package/eslint.config.js

@@ -0,0 +1,58 @@
+import { antfu } from '@antfu/eslint-config'
+
+/** @type {typeof antfu} */
+export default antfu(
+  {
+    ignores: [],
+    jsx: false,
+    rules: {
+      'curly': ['error', 'multi-line'],
+      'new-cap': 'off',
+      'no-undef': 'error',
+      'perfectionist/sort-exports': 'error',
+      'perfectionist/sort-imports': [
+        'error',
+        {
+          groups: [
+            ['type-builtin', 'type-external', 'type-internal'],
+            ['type-parent', 'type-sibling', 'type-index'],
+            'builtin',
+            'external',
+            'internal',
+            ['parent', 'sibling', 'index'],
+            'side-effect',
+            'unknown',
+          ],
+          order: 'asc',
+          type: 'natural',
+          newlinesBetween: 1,
+        },
+      ],
+      'perfectionist/sort-named-exports': 'error',
+      'perfectionist/sort-named-imports': 'error',
+      'quotes': ['error', 'single'],
+      'sort-imports': 0,
+      'style/brace-style': [
+        'error',
+        '1tbs',
+        { allowSingleLine: true },
+      ],
+      'style/quote-props': ['error', 'consistent-as-needed'],
+      'test/no-only-tests': 'error',
+      'unused-imports/no-unused-vars': [
+        'error',
+        { caughtErrors: 'none' },
+      ],
+    },
+    typescript: false,
+  },
+  {
+    files: ['**/*.md'],
+    rules: {
+      'perfectionist/sort-exports': 'off',
+      'perfectionist/sort-imports': 'off',
+      'perfectionist/sort-named-exports': 'off',
+      'perfectionist/sort-named-imports': 'off',
+    },
+  },
+)