peepshow/ how-to/ video-to-slack

Reel #H-07 Drop a video, get a Slack message with the highlight frames

peepshow how-to / video-to-slack

Post video highlights to Slack with peepshow

peepshow's Slack sink takes every run and posts an incoming-webhook message: title, thumbnail, scene-change frame URLs, deep link to the first frame. Pair with the auto-invoke hooks and a video drop into any agent broadcasts the highlights to your team channel.

Steps

  1. Install peepshow
    npm install -g peepshow
  2. Create a Slack incoming webhook

    Slack app → Incoming Webhooks → activate → pick a channel → copy the URL.

  3. Set the webhook URL
    export SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
  4. Run with the Slack sink

    Every run posts a message.

    peepshow ./demo.mp4 --sink slack
  5. Make it automatic

    Auto-sink list — every future run posts without the flag.

    peepshow sinks add slack

Why it works

Slack is the default surface for team notifications. peepshow's Slack sink slots in: bug repros, CCTV motion alerts, design walkthroughs all land in the channel of your choice with a usable thumbnail. Combine with `--when extension=mov` and you can fan only certain clips out — keep the channel signal high.

When it helps

  • QA team auto-posting screen-recording bug repros.
  • Security ops alerting on CCTV motion frames.
  • Design review channels — every Loom drop posts the highlight frames.

Pitfalls

  • Slack collapses message previews after 5 attachments — peepshow caps at 4 by default.
  • Webhook URLs are sensitive — don't commit them, use `direnv` / `1password-cli` to inject.
  • Long transcripts truncate; click-through links to the full report.

Works with these LLMs

Pairs with these sinks