ESCPUTIL(1)

📦
version 5.3.5 · 8 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

🖨️ ESCPUTIL(1) — Gutenprint Manual Pages 🖨️

okay so bestie, listen up 💖 this is the manual page for escputil, and it's literally your new bestie for keeping Epson Stylus inkjet printers from acting up. it lives in the Gutenprint Manual Pages universe and it's giving major "I can fix him" energy for your printer. 🎀

✨ SYNOPSIS ✨

escputil [ -P printer | -r device ] [ -m model ] [ -u ] [ -c | -n | -a |
-i | -d | -o | -s | -l | -M | -h ] [ -q ]

💅 DESCRIPTION 💅

escputil is a command line utility that does all the maintenance tasks on Epson Stylus inkjet printers. we're talking head alignment, head cleaning, nozzle check, printer identification, and retrieval of ink level from the printer. no cap, it's the whole self-care routine for your printer. ✨🫶

🌸 OPTIONS 🌸

escputil accepts these options, and yes, every single one matters:

  • -P, --printer-name=printer — Specify the name of the printer to operate on. The default is the default system printer. 👑
  • -r, --raw-device=device — Specify the name of the device to write to directly rather than going through a printer queue. You must use this (rather than specifying a printer) when retrieving ink levels or identifying the printer, or if you wish to perform head alignment without specifying the printer model. like, direct access only, bestie. 🔥
  • -m, --model=model — Specify the precise printer model for head alignment. precision is key, iykyk. 💅
  • -u, --new — The printer is a new printer (Stylus Color 740 or newer). shiny new toy vibes. ✨
  • -c, --clean-head — Clean the print head. This can also be performed from the printer front panel. spa day for your nozzles. 🧖‍♀️
  • -n, --nozzle-check — Print a nozzle test pattern. Dirty or clogged nozzles will show as gaps in the pattern. If you see any gaps, you should run a head cleaning pass or two. bestie, if it's giving gap, clean it. 😭
  • -a, --align-head — Align the print head. CAUTION: Misuse of this option may result in poor print quality and/or damage to the printer. You must either specify the printer model with the -m option, or use the raw printer device to allow escputil to detect the printer model. this is not a drill, fr fr. 💀
  • -i, --ink-level — Obtain the ink level from the printer. This requires read/write access to the raw printer device. we love data. 🌈
  • -d, --identify — Query the printer for make and model information. This requires read/write access to the raw printer device. who are you, printer? 👀
  • -o, --align-color — Align the color print head (used by Stylus Color 480 and 580 only). CAUTION: Misuse of this option may result in poor print quality and/or damage to the printer. niche but iconic. 🎀
  • -s, --status — Retrieve printer status. vibe check for your printer. 🦋
  • -l, --license — Display the license/warranty terms of this program. the legal tea. ☕
  • -M, --list-models — List the supported printer models. the roster. 👑
  • -h, --help — Display a list of all command line options. your cheat sheet. 📝
  • -q, --quiet — Suppress the banner. no intro, just vibes. 🤫

💀 BUGS 💀

okay so there are some glitches, and we need to talk about them:

  • USB-connected printers sometimes fail to identify or return ink levels. You may have to repeat the command. This is probably a timing issue in escputil, not a flaw in the printer. it's not the printer's fault, it's just a little dramatic. 🙈
  • Anything requiring bidirectional communication with the printer (identify, ink levels, or head alignment without specifying the printer model) requires read/write access to the printer port (for example /dev/lp0). This may require these operations to be performed as root. In addition, kernel support is required for bidirectional communication. For Linux version 2.2, CONFIG_PRINTER_READBACK should be enabled; this is called CONFIG_PARPORT_1284 on 2.4 and later kernels. like, permissions and kernel config are the whole plot. 🔐
  • If the printer is performing self-test or head cleaning on power up, the identify and ink level commands will time out, although the printer successfully receives the command. The command will need to be reissued when the printer is quiescent. just wait for it to chill, then try again. ⏳

👑 AUTHORS 👑

Robert Krawitz. the legend. 💖

Copyright © 2000 Robert Krawitz (rlk@alum.mit.edu)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. slay, open source royalty. 💅✨

🌐 OTHER INFORMATION 🌐

The homepage of the Gutenprint project from which this utility was contributed is located at http://gimp-print.sourceforge.net/. go visit, bestie. 🦋

🔗 SEE ALSO 🔗

lp(4), tunelp(8). the extended universe. 🌈

💖 this page is serving Version 5.3.5 realness, dated 12 Mar 2025, and it's literally iconic. periodt. 🎀✨
📦 where this page comes from