peepshow/ sinks/ otter

Reel #93 Meeting transcript

peepshow sink / otter

Otter.aiPOST a meeting-note summary to a Zapier / Make webhook wired into Otter.ai.

Otter.ai has no public write API as of 2026 — this sink ships the `peepshow → webhook` half of `peepshow → webhook → (Zapier / Make / n8n) → Otter`. POSTs a flat note + transcript JSON body.

drop · process · otter

What it does

[Otter.ai](https://otter.ai) is the AI meeting-notes service. Its write surface in 2026 is the [official Zapier app](https://help.otter.ai/hc/en-us) — Otter exposes no public REST write API. This sink ships the upstream half of the pipeline: it POSTs the peepshow run summary (plus optional whisper transcript) to a user-configured webhook URL. The user wires the downstream half — Zapier `Catch Hook` → Otter `Create Note`, or the equivalent in Make / n8n. The body is a flat JSON object (`meeting_title` · `note` · `transcript` · `duration` · `frames` · `thumbnail_url` · `tags` · `created_at`) so the Zapier/Make field-mapper picks every field up without nested object parsing.

When to reach for it

  • Have every screen-recording walkthrough land in your team's Otter workspace alongside actual meetings
  • Bridge peepshow runs into any Otter-adjacent workflow — Slack share, Notion meeting-notes db, calendar event
  • Pair with `--when` so only specific videos (e.g. `--when extension=mov,mp4`) trigger the Otter note

Install

npm i -g peepshow

Use it

# 1. In Zapier: create a 'Webhooks by Zapier' Catch Hook → wire to 'Otter.ai - Create Note'
# 2. Copy the catch-hook URL into OTTER_WEBHOOK_URL:
OTTER_WEBHOOK_URL="https://hooks.zapier.com/hooks/catch/123/abc/" \
peepshow ./standup.mov --sink otter

Make it automatic

Register the sink once — every run fires it afterward. Scope by --when so it only runs for matching videos.

peepshow sinks add otter
peepshow sinks add otter --when extension=mp4,mov
peepshow sinks add otter --when path=/Volumes/Work/

Configuration

  • OTTER_WEBHOOK_URL Destination webhook URL — typically a Zapier `Catch Hook`, Make webhook, or n8n webhook trigger wired into Otter. required
  • OTTER_TITLE_PREFIX Prefix prepended to the note title. Default `peepshow`. Set to empty string to omit.
  • OTTER_AUTH Optional verbatim `Authorization` header value (e.g. `Bearer …`) sent to the webhook. Useful for self-hosted glue or Make scenarios with auth.
  • PEEPSHOW_FRAME_BASE_URL When set, the first frame URL is written to the `thumbnail_url` field.

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 Otter.ai sink automatically when three things are true:

  • the env vars below are exported in the agent's shell (or a project .env it can load),
  • the peepshow CLI is on PATH — install with npm i -g peepshow,
  • a peepshow auto-sink is registered for the run (optional but recommended — makes invocation zero-argument).

1. Set the environment

# Add to ~/.zshrc, ~/.bashrc, or a project .env the agent can load
export OTTER_WEBHOOK_URL="..."

2. Register as an auto-sink

peepshow sinks add otter
peepshow sinks add otter --when extension=mp4,mov

3. Example LLM session

You → drop a .mov into Claude Code.

Claude → auto-invokes /peepshow:slides ./clip.mov. peepshow extracts frames + audio, the Otter.ai sink forwards the run to the configured Otter.ai 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'.