hp-setup(1)

📦
version 3.24.4 · 2 versions
, in ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 NAME 🌸

hp-setup — the Printer/Fax Setup Utility, bestie edition. (This one lives in the User Manuals collection, so you know it's official. 💅)

🎀 DESCRIPTION 🎀

Okay so real talk: hp-setup is the girl who gets your HPLIP printers and faxes actually installed into the CUPS spooler. She will try to automatically determine the correct PPD file to use — like, she'll figure it out herself, no cap. She also lets you print a testpage (iconic) and does basic fax parameter setup. Lowkey a whole entire tool. 🖨️✨

🦋 SYNOPSIS 🦋

hp-setup [MODE] [OPTIONS] [SERIAL NO.|USB bus:device|IP|DEVNODE]

✨ MODE ✨

  • -u or --gui — run it in graphical UI mode. This is the default, so if you just yeet hp-setup with no args, you're getting the GUI, periodt.
  • -i or --interactive — run it in interactive mode. Chatty, question-by-question, main character energy.

💖 OPTIONS 💖

  • -a or --auto — automatic mode. (-i mode only, iykyk.)
  • --port=<port> — to specify the port on a multi-port JetDirect. Valid values are 1*, 2, and 3. The * means 1 is the default.
  • -x — no testpage in automatic mode. (-i mode only.)
  • -p<printer> or --printer=<printer> — to specify a CUPS printer queue name. (-i mode only.)
  • -f<fax> or --fax=<fax> — to specify a CUPS fax queue name. (-i mode only.)
  • -t<typelist> or --type=<typelist> — type of queue(s) to install. <typelist> can be: print*, fax* — and * means default. (-i mode only.)
  • -d<device> or --device=<device> — to specify the device URI to install. (--qt4 mode only.)
  • -r or --rm or --remove — remove printers or faxes instead of setting them up. Breakup era. 💔
  • --loc=<lang> or --lang=<lang> — set the language. Use --loc=? or --lang=? to see a list of available language codes.
  • -l<level> or --logging=<level> — set the logging level. <level> can be: none, info*, error, warn, debug — with * marking default.
  • -g — run in debug mode. (Same as the option -ldebug.)
  • -h or --help — this help information. Slay.

🌈 SERIAL NO.|USB ID|IP|DEVNODE 🌈

  • USB bus:device (usb only) — "xxx:yyy" where xxx is the USB bus and yyy is the USB device. > Note: the : and all leading zeros must be present. Use the lsusb command to obtain this information.
  • IPs (network only) — IPv4 address "a.b.c.d" or "hostname".
  • DEVNODE (parallel only) — "/dev/parportX", where X=0,1,2,...
  • SERIAL NO. (usb and parallel only) — "serial no."

⭐ EXAMPLES ⭐

Setup using GUI mode:

$ hp-setup

Setup using GUI mode, specifying usb:

$ hp-setup -b usb

Setup using GUI mode, specifying an IP:

$ hp-setup 192.168.0.101

One USB printer attached, automatic:

$ hp-setup -i -a

USB, IDs specified:

$ hp-setup -i 001:002

Network:

$ hp-setup -i 66.35.250.209

Network, Jetdirect port 2:

$ hp-setup -i --port=2 66.35.250.209

Parallel:

$ hp-setup -i /dev/parport0

USB or parallel, using serial number:

$ hp-setup -i US12345678A

USB, automatic:

$ hp-setup -i --auto 001:002

Parallel, automatic, no testpage:

$ hp-setup -i -a -x /dev/parport0

Parallel, choose device:

$ hp-setup -i -b par

🔥 NOTES 🔥

  1. If no serial number, USB ID, IP, or device node is specified, the USB and parallel busses will be probed for devices. She'll go looking. 🕵️‍♀️
  2. Using lsusb to obtain USB IDs: (example)
$ lsusb

      Bus 003 Device 011: ID 03f0:c202 Hewlett-Packard
$ hp-setup --auto 003:011
Note: You may have to run lsusb from /sbin or another location. Use $ locate lsusb to determine this.
  1. Parameters -a, -f, -p, or -t are not valid in GUI (-u) mode. Don't try it, bestie, she said no. 🙈

👑 SEE ALSO 👑

hp-makeuri hp-probe

💜 AUTHOR 💜

HPLIP (HP Linux Imaging and Printing) is an HP developed solution for printing, scanning, and faxing with HP inkjet and laser based printers in Linux.

🫶 REPORTING BUGS 🫶

The HPLIP Launchpad.net site https://launchpad.net/hplip is available to get help, report bugs, make suggestions, discuss the HPLIP project or otherwise contact the HPLIP Team. Come hang out, fr fr.

Copyright (c) 2001-18 HP Development Company, L.P.

This software comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to distribute it under certain conditions. See COPYING file for more details.

Okay that's the whole page, no crumbs left. 💖 This was the Linux, version 9.0 edition of the hp-setup(1) manual page — thanks for reading, mwah. 🌸✨🦋

📦 where this page comes from