Skip to content

Meet Transcriber

Meet Transcriber is an autonomous bot that monitors your Google Calendar, joins Google Meet meetings automatically, records audio, transcribes the conversation, and delivers the transcript to Telegram.

What It Does

  1. Monitors Google Calendar — polls your calendar via headless browser every 5 minutes
  2. Auto-joins meetings — joins 1–2 minutes before start using Puppeteer + headless Chrome
  3. Records audio — captures all meeting audio via a PulseAudio virtual device + FFmpeg
  4. Transcribes — sends the recording to OpenAI Whisper API after the meeting ends
  5. Delivers to Telegram — posts the transcript (and status updates) to your Telegram bot

Tech Stack

Component Technology
Browser automation Node.js + Puppeteer (headless Chrome)
Audio capture PulseAudio virtual sink + FFmpeg
Transcription OpenAI Whisper API
State persistence SQLite (via better-sqlite3)
Notifications Telegram Bot API
Process management PM2
Infrastructure DigitalOcean Ubuntu 24.04 · Nginx · Let's Encrypt SSL

Server

  • Host: DigitalOcean 104.131.17.141
  • OS: Ubuntu 24.04 LTS
  • Stack: Node.js 22, Nginx, PM2, Certbot
Resource URL
Live status dashboard https://recorder.nicnames.dev
Status API https://api.recorder.nicnames.dev
Docs (this site) https://docs.recorder.nicnames.dev

Documentation Pages

  • Architecture — system design, module overview, data flow
  • Implementation — how each feature works under the hood
  • Decisions — why specific technologies and approaches were chosen
  • Tasks — current project status and known issues
  • Changelog — full history of changes
  • Status API — API reference for the monitoring endpoints
  • Project Summary — concise project overview