Steps
- Install peepshow
npm install -g peepshow - Create a Notion integration
Get a token at notion.so/profile/integrations. Share the target database with the integration.
- Set credentials
export NOTION_TOKEN=secret_... export NOTION_DATABASE_ID=... - Run with the Notion sink
Every run posts a new page.
peepshow ./demo.mp4 --sink notion - Make it automatic
Add Notion to the auto-sinks list — every future run posts without the flag.
peepshow sinks add notion
Why it works
Notion is where team knowledge lives. peepshow's Notion sink slots into that — every video review (demo, bug repro, design feedback) lands as a structured Notion page with metadata properties you can filter and a gallery block embedding the frames. The transcript snippet lives in a property too, so full-text search hits it.
When it helps
- Design teams archiving UI bug repros.
- Sales teams capturing product demo highlights.
- Research / journalism workflows where every clip needs a discoverable record.
Pitfalls
- Notion API rate limits — heavy bulk imports may throttle.
- Frame URLs are uploaded by the sink (configurable host); keep the host reachable from Notion.
- Long transcripts get truncated in the snippet property — full text lives in a child block.