printer

Manage printers via CUPS on macOS (discover, add, print, queue, status, wake).

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a comprehensive interface for managing macOS printers via CUPS (Common Unix Printing System). It enables users to perform advanced administrative tasks such as network printer discovery, driverless IPP configuration, queue management, and hardware diagnostics directly through command-line automation, significantly streamlining IT support workflows on macOS.

Use Cases

  • Automated Printer Provisioning: Quickly discover and add network printers using 'IPP Everywhere' protocols to set up new workstations without manual driver installation.
  • Remote Troubleshooting: Diagnose connectivity issues, wake printers from deep sleep, and monitor real-time status or error logs to resolve printing failures remotely.
  • Queue & Job Management: Efficiently manage high-volume printing environments by listing, canceling, or prioritizing jobs and toggling printer availability.
  • Consumables & Maintenance Monitoring: Check toner levels via SNMP and query detailed printer attributes to proactively manage office supplies and hardware health.
  • Custom Print Job Configuration: Execute precise print commands with specific parameters such as duplex printing, grayscale, and custom media sizes for batch processing.
nameprinter
descriptionManage printers via CUPS on macOS (discover, add, print, queue, status, wake).
metadata{"clawdbot":{"emoji":"🖨️","os":["darwin"],"requires":{"bins":["lp","lpstat","lpadmin"]}}}

Printer (CUPS)

Control printers on macOS using built-in CUPS commands. No external CLI needed.

Discover printers

# Network printers (Bonjour/AirPrint)
dns-sd -B _ipp._tcp . 2>/dev/null & sleep 3; kill $! 2>/dev/null

# Get printer details (host, port, resource path)
dns-sd -L "Printer Name" _ipp._tcp . 2>/dev/null & sleep 3; kill $! 2>/dev/null

# CUPS-native discovery
lpstat -e                         # available network destinations
lpinfo --include-schemes dnssd -v # dnssd backends

# IPP discovery
ippfind --timeout 5

Add a printer (driverless IPP Everywhere)

# Recommended: driverless queue
lpadmin -p MyPrinter -E -v "ipp://printer.local:631/ipp/print" -m everywhere

# Set as default
lpadmin -d MyPrinter

# Enable SNMP supply reporting (toner levels)
sudo lpadmin -p MyPrinter -o cupsSNMPSupplies=true
lp filename.pdf                      # to default printer
lp -d MyPrinter filename.pdf         # specific printer
lp -d MyPrinter -n 2 file.pdf        # 2 copies
lp -d MyPrinter -o sides=two-sided-long-edge file.pdf  # duplex
lp -d MyPrinter -o media=letter file.pdf
lp -d MyPrinter -o ColorModel=Gray file.pdf  # grayscale

# Print text directly
echo "Hello World" | lp -d MyPrinter

Queue management

# Check status
lpstat -p MyPrinter        # printer status
lpstat -o MyPrinter        # queued jobs
lpstat -t                  # everything
lpq -P MyPrinter           # BSD-style queue view

# Cancel jobs
cancel JOB_ID
cancel -a MyPrinter        # cancel all

# Enable/disable
cupsenable MyPrinter       # resume printing
cupsdisable MyPrinter      # pause printer
cupsaccept MyPrinter       # accept new jobs
cupsreject MyPrinter       # reject new jobs

Printer options

# List available options for a printer
lpoptions -p MyPrinter -l

# Set default options (per-user)
lpoptions -p MyPrinter -o sides=two-sided-long-edge

# Set server-side defaults
sudo lpadmin -p MyPrinter -o sides-default=two-sided-long-edge

Status and diagnostics

# IPP status query (detailed)
ipptool -t ipp://PRINTER_IP/ipp/print get-printer-attributes.test

# Filter for key info
ipptool -t ipp://PRINTER_IP/ipp/print get-printer-attributes.test \
  | grep -iE 'printer-state|marker|supply|media|error'

Wake printer from sleep

# IPP poke (usually wakes the printer)
ipptool -q -T 5 ipp://PRINTER_IP/ipp/print get-printer-attributes.test

# HTTP poke (wakes web UI stack)
curl -s -m 5 http://PRINTER_IP/ >/dev/null

# TCP connect test
nc -zw2 PRINTER_IP 631

Keep-alive (prevent deep sleep)

# Poll every 5 minutes (runs in foreground)
ipptool -q -T 3 -i 300 ipp://PRINTER_IP/ipp/print get-printer-attributes.test

For persistent keep-alive, create a launchd agent.

Toner levels via SNMP

Requires brew install net-snmp:

snmpwalk -v2c -c public PRINTER_IP 1.3.6.1.2.1.43.11.1.1

Note: SNMP may be disabled on the printer. Check Remote UI settings.

Remote UI (web interface)

Most network printers expose a web UI at http://PRINTER_IP/ for:

  • Sleep/timer settings (Settings > Timer Settings > Auto Sleep Time)
  • Network protocol config (enable/disable IPP, SNMP, raw 9100)
  • Consumables status

Troubleshooting

# Printer stuck/disabled? Re-enable it
cupsenable MyPrinter

# Check device URI
lpstat -v MyPrinter

# Remove and re-add printer
lpadmin -x MyPrinter
lpadmin -p MyPrinter -E -v "ipp://..." -m everywhere

# CUPS error log
tail -f /var/log/cups/error_log

Notes

  • Prefer ipp:// or ipps:// URIs over raw 9100 or LPD
  • -m everywhere auto-configures from printer's IPP capabilities
  • Option names vary by printer; use lpoptions -l to discover
  • Sleep settings are best configured via printer's Remote UI
  • Auto-sleep (1 min) keeps services alive - print jobs wake the printer automatically
  • If the printer is completely unresponsive (IPP port closed, HTTP timeout), it's likely in deep sleep or powered off. Message the user to check/wake the printer physically.