What it does
Post to a Discord channel via webhook. Uses embeds to show a grid of thumbnails and attaches the extracted frames inline — ideal for community bots that watch videos alongside users.
When to reach for it
- Community bot that summarises dropped videos on the fly
- Share clip breakdowns in a dev/art channel with frames inline
- Pipe agent output into a private Discord for async review
Install
npm i -g peepshowUse it
peepshow ./clip.mp4 --sink discord \
--sink-arg webhook=https://discord.com/api/webhooks/...Make it automatic
Register the sink once — every run fires it afterward. Scope by--whenso it only runs for matching videos.
peepshow sinks add discord
peepshow sinks add discord --when extension=mp4,mov
peepshow sinks add discord --when path=/Volumes/Work/Configuration
PEEPSHOW_DISCORD_WEBHOOKWebhook URL for the target channel.required
Write your own
A sink is any executable that reads the--emit jsonpayload on stdin. Shell, Node, Python, Go — the spec's indocs/PLUGINS.md. Register persistent ones withpeepshow sinks add-cmd 'your-command'.