for CUPS, in the terminal

Print queues
without leaving
the terminal.

Watch the queue, hold and cancel jobs, enable printers, send files, set quotas, read the daemon logs and export usage reports — one keyboard, no browser tab.

$ curl -fsSL https://raw.githubusercontent.com/icortesb/cupstui/main/scripts/install.sh | sh

Get started View on GitHub

cupstui

Six tabs, one binary

Queue

Live job list, refreshed every three seconds. Hold, release, cancel one job or every job — the tab carries the count.

Printers

Enable, disable, set a default, accept or reject jobs. Add and remove queues, set per-printer quotas and access.

Print

Browse to a file and send it. Copies, page ranges, duplex, colour and orientation, all from the keyboard.

History

Completed jobs from the CUPS page log — the durable record. Totals by user and by printer, exported to CSV.

Logs

The daemon logs, filtered by minimum level, jumped straight to the end when something just went wrong.

Remote

One filter, every screen

The queue and the history take the same query. A bare term is looked for everywhere; a prefixed one is scoped to a single field. Terms combine, and every one must match.

printer:epson user:ana state:held

Keys that stay put

Every screen paints the full terminal width. Text fields keep their keys instead of losing them to global shortcuts.

1–6 switch tab

jk move

/ filter

S sign in to a remote server

? help, right there in the app

Full key reference →

Install

Script

curl -fsSL https://raw.githubusercontent.com/icortesb/cupstui/main/scripts/install.sh | sh

Go

go install github.com/icortesb/cupstui/cmd/cupstui@latest

Source

git clone https://github.com/icortesb/cupstui && cd cupstui && make build

Tarball

Grab the build for your architecture from releases and put it on your PATH.

Requires CUPS, running. Nothing else. Permissions →

Print queues without leaving the terminal.