What it does
POST the full peepshow JSON payload (run metadata + paths + optional inlined frames) to any URL. Configurable headers, retries, timeout. The escape hatch — connects peepshow to anything the built-in sinks don't cover.
When to reach for it
- Hit your own internal ingestion endpoint
- Fan out to Zapier / n8n / Pipedream / workflow platforms
- Trigger serverless functions with a ready-to-use video payload
Install
npm i -g peepshowUse it
peepshow ./input.mp4 --sink webhook \
--sink-arg url=https://example.com/ingest \
--sink-arg header=Authorization:Bearer+xyzMake it automatic
Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.
peepshow sinks add webhook
peepshow sinks add webhook --when extension=mp4,mov
peepshow sinks add webhook --when path=/Volumes/Work/Configuration
PEEPSHOW_WEBHOOK_URLDefault URL if `--sink-arg url` is omitted.PEEPSHOW_WEBHOOK_TIMEOUT_MSRequest timeout. Default 10_000.
Use with an LLM agent
Every peepshow sink reads its config from env vars and receives a single JSON payload on stdin. An LLM agent (Claude Code, Cursor, Windsurf, Gemini, Codex) can drive the Webhook sink automatically when three things are true:
- the env vars below are exported in the agent's shell (or a project
.envit can load), - the
peepshowCLI is onPATH— install withnpm i -g peepshow, - a peepshow auto-sink is registered for the run (optional but recommended — makes invocation zero-argument).
1. Set the environment
This sink has no required env vars — it writes to a local path. Pass the destination via --sink-arg:
peepshow ./input.mp4 --sink webhook \
--sink-arg url=https://example.com/ingest \
--sink-arg header=Authorization:Bearer+xyz2. Register as an auto-sink
peepshow sinks add webhook
peepshow sinks add webhook --when extension=mp4,mov3. Example LLM session
You → drop a
.movinto Claude Code.Claude → auto-invokes
/peepshow:slides ./clip.mov. peepshow extracts frames + audio, theWebhooksink forwards the run to the configured Webhook target. Claude replies with a summary and a link to the created record.
The transcript rides along in the payload whenever the audio pass transcribes successfully.
Write your own
A sink is any executable that reads the --emit json payload on stdin. Shell, Node, Python, Go — the spec's in docs/PLUGINS.md. Register persistent ones with peepshow sinks add-cmd 'your-command'.