peepshow/sinks/notion

Reel #08Knowledge base

peepshow sink / notion

NotionOne Notion page per run, filed into a database.

Creates a page with metadata properties, embedded thumbnails, and the full frame gallery.

What it does

File every peepshow run as a rich page in a Notion database: fills in Title, Director, Genre, and any container-metadata properties you've defined, then embeds the frames directly into the page body.

When to reach for it

  • Research log: agents add to a shared Notion research database automatically
  • Video playbook: keep every processed reference clip alongside its analysis
  • Content pipeline: turn raw media into a structured Notion library

Install

npm i -g peepshow

Use it

peepshow ./talk.mp4 --sink notion \
  --sink-arg database=abc123def456...

Make it automatic

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

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

Configuration

  • PEEPSHOW_NOTION_TOKENInternal integration token.required
  • PEEPSHOW_NOTION_DATABASEDatabase ID to file runs into.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'.