George Lambert
b40e862082
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.
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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](https://customer.verae.ai/portal/) / [zap.verae.ai](https://zap.verae.ai/portal/) Security tab:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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](docs/superpowers/specs/2026-10-03-print-to-verae-timestamp.md) and [plan](docs/superpowers/plans/2026-10-03-print-to-verae-timestamp.md).
|
|
|
|
## Contributing
|
|
|
|
Open questions and design changes in this repository. Pull requests are accepted for review against the spec.
|
|
|
|
## License
|
|
|
|
UNLICENSED © Verae / George Lambert
|