hp-setup

hp-setup [OPTION]...

-i, --interactive
    Runs the setup utility in interactive text mode.

-g, --gui
    Launches the graphical user interface for the setup utility. This is often the default behavior if a display is available.

-b <bus-type>, --bus=<bus-type>
    Scans for devices connected on a specific bus type (e.g., usb or net).

-u <device-uri>, --uri=<device-uri>
    Specifies a direct device URI for setup, bypassing device detection (e.g., hp:/net/HP_LaserJet_P2055dn?ip=192.168.1.100).

-a, --add
    Adds the detected or specified printer device to CUPS without starting the full interactive setup. Requires a --uri or detected device.

--cups-test
    Prints a test page after successfully setting up the printer in CUPS.

--plugin
    Forces the download and installation of any required proprietary HPLIP plugins, even if not automatically prompted.

--no-cups
    Skips the CUPS printer configuration step.

-v, --version
    Displays the HPLIP version information.

-h, --help
    Shows a help message and exits.

hp-setup is a fundamental command-line utility from the HPLIP (HP Linux Imaging and Printing) project. Its primary purpose is to simplify the installation and configuration of HP printers and multi-function devices on Linux systems.

The command guides users through the process of detecting connected devices (via USB or network), downloading and installing necessary proprietary plug-ins (if required), configuring the appropriate drivers, and integrating the device with the CUPS (Common Unix Printing System) print server. It supports both interactive text-based setup and, by default or with the --gui option, can launch a graphical user interface for easier navigation. hp-setup is crucial for ensuring full functionality, including printing, scanning, and faxing capabilities, for a wide range of HP hardware.

Using hp-setup typically requires root privileges (e.g., via sudo) to modify system-wide CUPS configurations and install necessary drivers or plugins. An active internet connection may be required for downloading proprietary HPLIP plugins. Ensure CUPS is running before attempting to set up a printer. Compatibility may vary with specific HP printer models and HPLIP versions.

hp-setup is a core component of the HPLIP project, which was initiated by HP to provide comprehensive and robust Linux support for its printing and imaging devices. The command has evolved significantly over the years, adapting to new printer technologies, network protocols, and Linux distribution changes, while maintaining its central role in user-friendly printer setup.

hp-check(1), hp-plugin(1), hp-info(1), lpadmin(8), cupsd(8)