hp-scan(1)

✨ NAME ✨

hp-scan — Scan Utility 💖

---

🌸 DESCRIPTION 🌸

okay bestie, so hp-scan is a SANE-based scan utility for HPLIP supported all-in-one/mfp devices 💅

Like. It scans. That's the vibe. ✨

---

🎀 SYNOPSIS 🎀

hp-scan [DEVICE_URI|PRINTER_NAME] [MODE] [OPTIONS]

---

💫 PRINTER|DEVICE-URI 💫

Gotta tell it what to scan with, bestie, no cap:

• -d<device-uri> or --device=<device-uri> — to specify a device-URI
• -p<printer> or --printer=<printer> — to specify a CUPS printer

---

🦋 MODE 🦋

• -i or --interactive — run in interactive mode ✨

---

👑 OPTIONS 👑

• -l<level> or --logging=<level> — set the logging level, where <level> is one of: none, info*, error, warn, debug (*default)
• -g — run in debug mode (same as option: -ldebug)
• -h or --help — this help information 🫶

---

💜 OPTIONS (GENERAL) 💜

🌈 Scan destinations

• -s<dest_list> or --dest=<dest_list> — where <dest_list> is a comma separated list containing one or more of: 'file', 'viewer', 'editor', 'pdf', or 'print'. Use only commas between values, no spaces. (fr fr, no spaces 🙈)

🌸 Scan mode

• -m<mode> or --mode=<mode> — where <mode> is 'gray'*, 'color' or 'lineart'

⭐ Scanning resolution

• -r<resolution_in_dpi> or --res=<resolution_in_dpi> or --resolution=<resolution_in_dpi> — where 300 is default

🎀 Image resize

• --resize=<scale_in_%> — min=1%, max=400%, default=100%

💅 Color Dropout Red

• -color_dropout_red_value=<color_dropout_red_value> or --color_dropout_red_value=<color_dropout_red_value>

💅 Color Dropout Green

• -color_dropout_green_value=<color_dropout_green_value> or --color_dropout_green_value=<color_dropout_green_value>

💅 Color Dropout Blue

• -color_dropout_blue_value=<color_dropout_blue_value> or --color_dropout_blue_value=<color_dropout_blue_value>

💅 Color Dropout Range

• -color_range=<color_range> or --color_range=<color_range>

🌈 Image contrast

• -c=<contrast> or --contrast=<contrast> — the contrast range varies from device to device, so it's giving "it depends" 😭

🌈 Image brightness

• -b=<brightness> or --brightness=<brightness> — the brightness range varies from device to device too, same energy

🍓 ADF mode

• --adf — note, only PDF output is supported when using the ADF
• --duplex or --dup — for duplex scanning using ADF

---

🧚 OPTIONS (SCAN AREA) 🧚

📏 Specify the units for area/box measurements

• -t<units> or --units=<units> — where <units> is 'mm'*, 'cm', 'in', 'px', or 'pt' ('mm' is default)

🔲 Scan area

• -a<tlx>,<tly>,<brx>,<bry> or --area=<tlx>,<tly>,<brx>,<bry> — coordinates are relative to the upper left corner of the scan area. Units for tlx, tly, brx, and bry are specified by -t/--units (default is 'mm'). Use only commas between values, no spaces.

🔲 Scan box

• --box=<tlx>,<tly>,<width>,<height> — tlx and tly coordinates are relative to the upper left corner of the scan area. Units for tlx, tly, width, and height are specified by -t/--units (default is 'mm'). Use only commas between values, no spaces.

🔲 Top left x of the scan area

• --tlx=<tlx> — coordinates are relative to the upper left corner of the scan area. Units are specified by -t/--units (default is 'mm').

🔲 Top left y of the scan area

• --tly=<tly> — coordinates are relative to the upper left corner of the scan area. Units are specified by -t/--units (default is 'mm').

🔲 Bottom right x of the scan area

• --brx=<brx> — coordinates are relative to the upper left corner of the scan area. Units are specified by -t/--units (default is 'mm').

🔲 Bottom right y of the scan area

• --bry=<bry> — coordinates are relative to the upper left corner of the scan area. Units are specified by -t/--units (default is 'mm').

📄 Specify the scan area based on a paper size

• --size=<paper size name> — where <paper size name> is one of: 3x5, 4x6, 5x7, a2_env, a3, a4, a5, a6, b4, b5, c6_env, dl_env, exec, flsa, higaki, japan_env_3, japan_env_4, legal, letter, no_10_env, oufufu-hagaki, photo, super_b

✂️ Crop out edges from the scan area

• --edge_erase_value=<border crop value in inch> — where <border crop value in inch> is in range of: [0-1]inch

---

💖 OPTIONS ('FILE' DEST) 💖

• -o<file> or -f<file> or --file=<file> or --output=<file> — filename for 'file' destination

---

💖 OPTIONS ('PDF' DEST) 💖

• --pdf=<pdf_viewer> — PDF viewer application

---

💖 OPTIONS ('VIEWER' DEST) 💖

• -v<viewer> or --viewer=<viewer> — image viewer application

---

💖 OPTIONS ('EDITOR' DEST) 💖

• -e<editor> or --editor=<editor> — image editor application

---

💌 OPTIONS ('EMAIL' DEST) 💌

• --email-from=<email_from_address> — From: address for 'email' dest (required for 'email' dest.)
• --email-to=<email__to_address> — To: address for 'email' dest (required for 'email' dest.)
• --email-subject="<subject>" or --subject="<subject>" — email subject for 'email' dest. Use double quotes (") around the subject if it contains space characters.
• --email-msg="<msg>" or --email-note="<note>" — note or message for the 'email' dest. Use double quotes (") around the note/message if it contains space characters.

ok so heads up bestie, the To: one really is spelled --email-to=<email__to_address> with the double underscore. not a typo on my part, that's just how it is 💀

---

🖨️ OPTIONS ('PRINTER' DEST) 🖨️

• --dp=<printer_name> or --dest-printer=<printer_name> — printer queue/printer dest
• --dd=<device-uri> or --dest-device=<device-uri> — printer device-URI dest

---

🔥 OPTIONS (ADVANCED) 🔥

• -x<mode> or --compression=<mode> — set the scanner compression mode, <mode>='raw', 'none' or 'jpeg' ('jpeg' is default) ('raw' and 'none' are equivalent)

---

👀 SEE ALSO 👀

(yeah bestie, it's literally empty in the original. iconic of it honestly 💅)

---

🫶 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.

---

⚖️ COPYRIGHT ⚖️

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.

no cap on that one — ABSOLUTELY NO WARRANTY is in all caps in the original and it means exactly what it says 😭

---

and that's the whole page bestie, mwah 💋 this was the hp-scan manual, section 1 of the User Manuals, version 2.2 on Linux — go scan something cute, ily, bye ✨💖🦋