IppCli 5.0.1

IppCli (ipp-cli)

IppCli is a cross-platform command-line tool for interacting with Internet Printing Protocol (IPP) printers, print servers (e.g. CUPS), and IPP System Services. Built on .NET 10 with SharpIppNext and Spectre.Console.

Features

• Standard IPP Operations: Complete coverage of RFC 8011, RFC 3995, RFC 3996, RFC 3998, PWG 5100.5, PWG 5100.13, and PWG 5100.22.
• Top-Level Commands: Direct, standard IPP operation commands without nested subcommands.
• Flexible Options & JSON Support: Configure individual parameters via command-line flags or supply full/partial JSON payloads (inline or via @file.json).
• Multiple Output Formats: Rich formatted Spectre.Console tree (Tree) or machine-readable indented JSON (Json).
• SSL / TLS Flexibility: Built-in -k / --insecure option to bypass SSL validation for local devices with self-signed certificates.
• Packaged as .NET Tool: Install globally using dotnet tool install -g IppCli and execute anywhere via ipp-cli.

Installation

As a Global .NET Tool

dotnet tool install -g IppCli

From Source

git clone https://github.com/danielklecha/IppCli.git
cd IppCli
dotnet build -c Release

Options & Syntax

Core Options

All commands support the following core settings:

Attribute Groups & Prefix Conventions

IPP operation parameters are organized by attribute group prefixes:

• Operation Attributes (--op-*): Parameters sent in the operation attributes group.
  • --op <JSON>: Full Operation Attributes JSON string or @file.json
  • --op-printer-uri <URI>: Target printer or service URI (e.g. ipp://..., ipps://..., http://...)
  • --op-job-uri <URI>: Target job URI
  • --op-job-id <ID>: Target job ID
  • --op-document-number <NUM>: Document sequence number
  • --op-requesting-user-name <USER>: Requesting user name (defaults to current OS user)
  • --op-requested-attributes <ATTRS>: Comma-separated list of attributes to query
  • --op-which-jobs <VALUE>: Job queue filter (completed, not-completed, all)
  • --op-my-jobs: Filter jobs submitted by the current user
  • --op-message <TEXT>: Reason or message associated with the operation
• Job Template Attributes (--jta-*): Job configuration settings.
  • --jta <JSON>: Full Job Template Attributes JSON string or @file.json
  • --jta-copies <COUNT>: Number of copies
  • --jta-sides <VALUE>: Duplex mode (one-sided, two-sided-long-edge, two-sided-short-edge)
  • --jta-print-color-mode <VALUE>: Color mode (color, monochrome, auto)
  • --jta-media <NAME> / --jta-media-col <JSON>: Media type, size, and tray collection
• Printer Attributes (--pa-*): Printer administrative settings.
  • --pa <JSON>: Full Printer Attributes JSON string or @file.json
  • --pa-printer-info <TEXT>, --pa-printer-location <TEXT>, etc.
• Document Template Attributes (--dta-*): Document-level settings.
  • --dta <JSON>: Full Document Template Attributes JSON string or @file.json
  • --dta-copies <COUNT>, --dta-media-col <JSON>, etc.
• Document Stream (--document <PATH>): File path to upload when using print-job or send-document.

Commands

All IPP operations are available as top-level commands:

Examples

Query Printer Attributes

ipp-cli get-printer-attributes --op-printer-uri ipp://192.168.1.50:631/ipp/print

Print a PDF File in Duplex

ipp-cli print-job --op-printer-uri ipps://printer.local/ipp/print --document document.pdf --jta-copies 2 --jta-sides TwoSidedLongEdge -k

List Pending Jobs in JSON

ipp-cli get-jobs --op-printer-uri ipp://192.168.1.50:631/ipp/print --op-which-jobs not-completed -o Json

Cancel a Specific Job

ipp-cli cancel-job --op-printer-uri ipp://192.168.1.50:631/ipp/print --op-job-id 105 --op-message "User canceled"

Query Document Attributes

ipp-cli get-document-attributes --op-printer-uri ipp://192.168.1.50:631/ipp/print --op-job-id 105 --op-document-number 1

Set Printer Attributes

ipp-cli set-printer-attributes --op-printer-uri ipp://localhost:631/printers/LaserJet --pa-printer-info "Office Color Laser" --pa-printer-location "Room 302"

List All CUPS Printers

ipp-cli cups-get-printers --op-printer-uri ipp://localhost:631

Supply Full Request JSON from File

ipp-cli print-job --request @request.json

License

This project is licensed under the MIT License.