hp-setup

Installs HPLIP-supported HP printers and faxes into the CUPS spooler

TLDR

Launch the graphical setup wizard (default when no mode is given)

$ hp-setup

Run the text-based interactive wizard

$ hp-setup -i

Set up a USB printer automatically, no prompts, using its bus:device ID from lsusb

$ hp-setup -i -a [001:002]

Set up a network printer by IP address, automatically and without a test page

$ hp-setup -i -a -x [192.168.1.100]

Remove an installed printer

$ hp-setup -r -p [printer-name]

SYNOPSIS

hp-setup [MODE] [OPTIONS] [SERIAL-NO|USB-BUS:DEVICE|IP|DEVNODE]

hp-setup discovers an HP printer (USB, network/JetDirect, or parallel port) and installs it into the CUPS spooler, automatically choosing an appropriate PPD/driver and, for fax-capable models, setting up a fax queue and basic fax parameters. It can also print a test page as part of installation.Run with no arguments it opens the Qt graphical wizard. For scripted or headless installs, use -i for the text-based wizard, adding -a to skip all interactive prompts, and optionally -x to skip the test page. A device can be targeted directly by USB bus:device ID (from lsusb), IP address, hostname, serial number, or parallel port devnode; without one, hp-setup probes USB and parallel buses for a compatible printer.

PARAMETERS

-u, --gui

Run the graphical (Qt) setup wizard. This is the default when no mode is given.

-i, --interactive

Run the text-based interactive setup wizard.

-a, --auto

Non-interactive automatic setup, skipping prompts (interactive mode only).

-x

Skip printing a test page in automatic mode (interactive mode only).

-p printer, --printer=printer

Set the CUPS printer queue name (interactive mode only).

-f fax, --fax=fax

Set the CUPS fax queue name (interactive mode only).

-t typelist, --type=typelist

Queue types to create: print, fax (interactive mode only).

-d device-uri, --device=device-uri

Specify the device URI directly (GUI mode only).

-r, --rm, --remove

Remove the printer/fax queue instead of installing it.

--port=port

Multi-port JetDirect port number: 1 (default), 2, or 3.

-l level, --logging=level

Set logging verbosity: none, info, error, warn, or debug.

-g

Run with debug-level logging (equivalent to -l debug).

-h, --help

Display help and exit.

INSTALL

sudo apt install hplip

sudo dnf install hplip

sudo pacman -S hplip

sudo zypper install hplip

nix profile install nixpkgs#hplip

CAVEATS

Part of the HPLIP package. Installing print queues typically requires root or a user in the CUPS lpadmin group. Some models require HP's proprietary binary plugin, which hp-setup will offer to download and install (needs internet access) via hp-plugin.