1.1.1 • Published 3 years ago

homebridge-printer v1.1.1

Weekly downloads
105
License
MIT
Repository
github
Last release
3 years ago

homebridge-printer

npm npm GitHub last commit verified-by-homebridge Discord Donate

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

Info

This is a dynamic platform plugin for Homebridge to check the state of your ipp (AirPrint) capable printer.

This Plugin creates a Switch Accessory and ContactSensor Accessory with FakeGato functionality. The Switch Accessory shows if the printer is online or offline and the ContactSensor Accessory shows if the printer is printing.

Installation instructions

After Homebridge has been installed:

  • sudo npm i -g homebridge-printer@latest

Basic configuration

{
 "bridge": {
   ...
 },
 "accessories": [
   ...
 ],
 "platforms": [
   {
     "platform": "PrinterPlatform",
     "debug": true,
     "printer":[
       {
         "name": "HP Envy Pro",
         "address": "http://hpf92bab4321ab:631/ipp/printer",
         "polling": 10,
         "marker": true,
         "switchType": "SWITCH",
         "manufacturer": "HP",
         "model": "Envy Pro",
         "serialNumber": "12345"
       }
     ]
   }
 ]
}

See Example Config for more details.

Options

AttributesRequiredUsage
platformYesMust be PrinterPlatform
debugNoEnables additional output in the log.
printer.addressYesIPP address of the printer.
printer.pollingNoPrinter state polling. (Default: 10s)
printer.markerNoIf enabled, a new filter characteristic will be shown within printer accessory to show marker level. (Default: false)
printer.switchTypeNoAccessory type of the printer switch. If "CHARACTERISTIC" is choosen, the printer switch will be shown as a characteristic within contact accessory. (Default: SWITCH)
printer.manufacturerNoManufacturer name for display in the Home app.
printer.modelNoModel name for display in the Home app.
printer.serialNumberNoSerialnumber for display in the Home app.

Supported clients

This plugin has been verified to work with the following apps on iOS 12.2 and iOS 12.3 Beta:

  • iOS 14+
  • Apple Home
  • All 3rd party apps like Elgato Eve etc.
  • Homebridge v1.1.6+

Contributing

You can contribute to this homebridge plugin in following ways:

Pull requests are accepted.

Troubleshooting

If you have any issues with the plugin then you can run this plugin in debug mode, which will provide some additional information. This might be useful for debugging issues. Just enable debug in your config and restart homebridge.