hpapi is a Python package for discovering and interacting with HP printers on the network. It allows users to discover printers, check their scanning status, and initiate scans. Please note that this package is not affiliated with HP and is an independent project.

• Installation
• Usage
• Discover Class
• Connect Class
• Important Notes
• License
• Creator

pip install hpapi

from hpapi import Discover, Connect

# Example usage
discovery = Discover()
printers = await discovery.discover_printers()
print(printers)

# Assuming 'printer_ip' is the IP address of an HP printer
connection = Connect(printer_ip)
status = await connection.scan_status()
print(status)

# Initiate a scan (example with default settings)
scan_result = await connection.scan()
if scan_result:
    with open('scanned_document.pdf', 'wb') as f:
        f.write(scan_result)

Discovers HP printers on the local network and returns a dictionary with printer information.

Fetches the scanning status of the connected HP printer and returns a dictionary.

Initiates a scan with the specified settings and returns the scanned document content as bytes. Returns None on failure.

Fetches the consumable status of the connected HP printer asynchronously and returns a dictionary containing information about consumables such as toner levels. Returns an error message as a string on failure.

• Disclaimer: This project is not affiliated with HP.
• Webscan and Authentication: Webscan must be enabled, and authentication must be disabled for the package to work properly with HP printers.
• Compatibility: This package was tested with the HP DeskJet 5075 model.

This project is licensed under the MIT License - see the LICENSE file for details.