Fireflies.ai — Hand each run's audio to Fireflies.ai for meeting-grade transcription + indexing.

What it does

[Fireflies.ai](https://fireflies.ai) is the AI meeting assistant that records, transcribes, and searches Zoom / Google Meet / Teams calls. Its [GraphQL API](https://docs.fireflies.ai/graphql-api/intro) exposes an `uploadAudio` mutation that asynchronously ingests an arbitrary audio URL — Fireflies fetches it, transcribes it with its own engine, and stores it as a fully-searchable meeting. This sink composes that mutation against the audio peepshow extracts on its second ffmpeg pass. The audio file is local, so the URL has to be resolved from `FIREFLIES_AUDIO_BASE_URL` (mirroring `outputDir` to a public bucket via the `s3` / `gcs` / `dropbox` sink) or set explicitly via `FIREFLIES_AUDIO_URL`. Authentication is a single Bearer API key from the Fireflies dashboard.

When to reach for it

• Pipe internal recordings (standups, demos, customer calls) into the same Fireflies workspace your live meetings already populate
• Build a single searchable archive of every video clip an agent processes — Fireflies' search beats grep over raw transcripts
• Trigger Fireflies-side automations (Zapier, webhook outputs) on every peepshow run without writing a custom integration

Install

npm i -g peepshow

Use it

FIREFLIES_API_KEY="ff_pat_xxx" \
FIREFLIES_AUDIO_BASE_URL="https://peepshow-public.s3.amazonaws.com/runs/abc" \
peepshow ./standup.mp4 --sink fireflies

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 fireflies
peepshow sinks add fireflies --when extension=mp4,mov
peepshow sinks add fireflies --when path=/Volumes/Work/

Configuration

• FIREFLIES_API_KEY Personal API key (Bearer auth). Generate in the Fireflies dashboard → Integrations → Fireflies API. required
• FIREFLIES_API_URL Override the GraphQL endpoint. Default `https://api.fireflies.ai/graphql`.
• FIREFLIES_TITLE Override the transcript title shown in Fireflies. Default: video.tags.title / .show / `peepshow run`.
• FIREFLIES_AUDIO_BASE_URL Public base URL that mirrors `payload.outputDir`. Joined with `basename(audio.path)`. Required when no `FIREFLIES_AUDIO_URL` is set.
• FIREFLIES_AUDIO_URL Explicit URL passed to `uploadAudio`. Wins over the derived URL.
• FIREFLIES_ATTENDEES Comma-separated attendee emails to pre-populate on the meeting record.
• FIREFLIES_LANGUAGE BCP-47 language hint, e.g. `en`, `es`, `de`.

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

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

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'.