PrintToVeraeTimeStamp/README.md
George Lambert b40e862082 feat(macos): Verae Timestamping in Print Destination list
Replace buried PDF Services as the primary UX with an IPP Everywhere
virtual printer (ippeveprinter LaunchAgent) named Verae Timestamping.
Jobs save {name}.pdf + {name}-verae-timestamp-{RECEIPTID}.pdf.
Also add /Applications/Verae Print Stamp.app for drop/Open With.
2026-10-03 04:10:17 -04:00

2.1 KiB

PrintToVeraeTimeStamp

macOS Print → PDF helper that saves {name}.pdf, stamps the digest with Verae, and writes {name}-verae-timestamp-{RECEIPTID}.pdf.

Only the SHA-256 digest is sent to Verae. Document bytes never leave the machine.

Install

cd /Users/marchon/research/PrintToVeraeTimeStamp
go build -o "$HOME/bin/verae-print" ./cmd/verae-print
verae-print install-printer   # Print → Destination → Verae Timestamping

Optional (buried PDF submenu): verae-print install-macos

Ensure $HOME/bin is on your PATH. Refresh Verae Time login when the JWT expires:

uvx verae-mcp-timestamping-server setup
# or session check:
uvx verae-mcp-timestamping-server session

For the Zapier channel, store an xVerae- token from customer.verae.ai / zap.verae.ai Security tab:

mkdir -p ~/.verae
chmod 700 ~/.verae
printenv XVERAE_TOKEN > ~/.verae/xverae-token   # or paste once
chmod 600 ~/.verae/xverae-token

Usage

In any app: File → Print → Destination → Verae Timestamping → Print.

Also: drop a PDF on Verae Print Stamp in /Applications, or Open With.

CLI:

verae-print stamp [--channel=verae|zapier] [--out-dir DIR] [--name STEM] [--open] file.pdf

Default output directory: ~/Documents/Verae Timestamps/

File Content
{name}.pdf Exact printed bytes (proven artifact)
{name}-verae-timestamp-{RECEIPTID}.pdf Registration / certificate PDF
{name}.verae.json Receipt sidecar

Channels:

  • verae (default) — api.veraetime.net + JWT in ~/.verae/auth.properties
  • zapier — zap.verae.ai + xVerae- + attachPdf:true

Status

macOS v0 (PDF Services) is implemented. CUPS virtual printer, Linux, and Windows remain per the spec and plan.

Contributing

Open questions and design changes in this repository. Pull requests are accepted for review against the spec.

License

UNLICENSED © Verae / George Lambert