A Node.js application that connects to video meetings (Zoom, Google Meet, Microsoft Teams) and provides real-time audio transcription with a beautiful TUI dashboard. Supports multiple transcription providers through the VoiceRouter SDK.
- Multi-Provider Transcription: Gladia, Deepgram, AssemblyAI (easily switchable)
- Real-Time TUI Dashboard: Live transcription display with audio visualization
- Two Operating Modes:
- Remote Mode: Bot joins meetings via MeetingBaas API
- Local Mode: Accept audio from any WebSocket source
- Automatic Transcript Logging: Sessions saved to organized folders with JSON, TXT, and raw logs
- Built-in Webhook Server: Receive MeetingBaas events directly
- Audio Recording: Optionally save meeting audio to WAV files
- Audio Playback: Listen to meeting audio through your speakers
- Graceful Shutdown: Data storage summary on exit
- Node.js (v18 or later)
- pnpm (or npm/yarn)
- MeetingBaas API key
- At least one transcription provider API key (Gladia, Deepgram, or AssemblyAI)
- Ngrok or similar tool for exposing local endpoints (for remote mode)
-
Clone the repository:
git clone https://github.com/Meeting-Baas/realtime-meeting-transcription.git cd realtime-meeting-transcription -
Install dependencies:
pnpm install
-
Create a
.envfile:# Required MEETING_BAAS_API_KEY=your_meetingbaas_api_key # At least one transcription provider (Gladia is default) GLADIA_API_KEY=your_gladia_api_key # DEEPGRAM_API_KEY=your_deepgram_api_key # ASSEMBLYAI_API_KEY=your_assemblyai_api_key # Optional: Choose provider (default: gladia) TRANSCRIPTION_PROVIDER=gladia # Optional: Server config PROXY_HOST=0.0.0.0 PROXY_PORT=4040 # Optional: Features ENABLE_TRANSCRIPT_LOGGING=true ENABLE_AUDIO_RECORDING=false ENABLE_AUDIO_PLAYBACK=false
The bot joins a meeting via MeetingBaas API and streams audio to your local proxy:
-
Start ngrok to expose your local server:
ngrok http 4040
-
Run the application:
# Basic usage (webhook URL auto-derived from streaming URL) pnpm run remote <meeting_url> [bot_name] <ngrok_wss_url> # Example pnpm run remote "https://meet.google.com/abc-defg-hij" "My Bot" "wss://abcd.ngrok-free.app"
The webhook URL is automatically derived:
wss://...→https://.../webhooks/meetingbaas -
The TUI dashboard will display:
- Live transcriptions with timestamps
- Audio visualization
- System logs
- Configuration status
-
Press
Ctrl+Cto stop. You'll see a data storage summary showing where transcripts and logs were saved.
Accept audio from any WebSocket source (Docker bots, custom clients):
pnpm run dev:localThe proxy listens on ws://localhost:4040 for incoming audio streams.
The application features a real-time terminal UI showing:
╔═══════════════════════════════════════════════════════════════════════════════╗
║ 🎙️ Real-Time Meeting Transcription ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ Mode: Remote | Provider: gladia | Port: 4040 | Uptime: 2:45 ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║ Speaker: John Smith ║
╠═════════════════════════════════════════════════════════════════════════[▁▃▅]═╣
║ ║
║ 💬 Live Transcription │ 📋 Logs ║
║ ─────────────────────────────────────────│────────────────────────────────────║
║ [2:43] Hello everyone, let's get started │ ℹ️ Bot joined meeting ║
║ [2:44] Thanks for joining today │ ℹ️ Transcription active ║
║ [2:45] First topic is the Q4 results │ ℹ️ Speaker: John Smith ║
╚═══════════════════════════════════════════════════════════════════════════════╝
Automatically saved to ./transcripts/sessions/{timestamp}_{uuid}/:
transcript.json- Structured JSON with all datatranscript.txt- Human-readable formatraw_logs.txt- Real-time logs with interim transcriptssession_info.txt- Session metadata
Saved to ./logs/process-{timestamp}.log with all system events.
When enabled, saved to ./recordings/recording_{timestamp}.wav (16-bit PCM, 16kHz, mono).
On exit, you'll see where all data was stored:
╔═══════════════════════════════════════════════════════════════════╗
║ 📁 DATA STORAGE SUMMARY ║
╚═══════════════════════════════════════════════════════════════════╝
📝 Process Logs:
./logs/process-2025-12-19T10-30-45.log
💬 Transcription Session:
./transcripts/sessions/20251219_103045_a1b2c3d4/
• Duration: 125.45s
• Transcripts: 42
🎤 Audio Recording:
./recordings/recording_2025-12-19T10-30-45.wav
• Size: 24.56 MB
| Variable | Default | Description |
|---|---|---|
MEETING_BAAS_API_KEY |
- | MeetingBaas API key (required) |
GLADIA_API_KEY |
- | Gladia transcription API key |
DEEPGRAM_API_KEY |
- | Deepgram transcription API key |
ASSEMBLYAI_API_KEY |
- | AssemblyAI transcription API key |
TRANSCRIPTION_PROVIDER |
gladia |
Default provider: gladia, deepgram, assemblyai |
PROXY_HOST |
0.0.0.0 |
Server host |
PROXY_PORT |
4040 |
Server port |
ENABLE_TRANSCRIPT_LOGGING |
true |
Save transcripts to files |
TRANSCRIPT_OUTPUT_DIR |
./transcripts |
Transcript output directory |
ENABLE_AUDIO_RECORDING |
false |
Save audio to WAV files |
AUDIO_OUTPUT_DIR |
./recordings |
Audio output directory |
ENABLE_AUDIO_PLAYBACK |
false |
Play audio through speakers |
MEETING_BAAS_API_URL |
https://api.meetingbaas.com |
MeetingBaas API URL |
# Use Deepgram
TRANSCRIPTION_PROVIDER=deepgram pnpm run remote ...
# Use AssemblyAI
TRANSCRIPTION_PROVIDER=assemblyai pnpm run remote ...┌─────────────────┐ ┌──────────────────┐ ┌─────────────────────┐
│ MeetingBaas │────▶│ Proxy Server │────▶│ VoiceRouter SDK │
│ (Bot in call) │ │ (WebSocket + │ │ (Gladia/Deepgram/ │
│ │◀────│ HTTP Webhooks) │◀────│ AssemblyAI) │
└─────────────────┘ └──────────────────┘ └─────────────────────┘
│
▼
┌──────────────────┐
│ TUI Dashboard │
│ + Transcript │
│ Logger │
└──────────────────┘
Components:
- MeetingBaas Client (
src/meetingbaas.ts): Manages bot lifecycle via MeetingBaas API - Proxy Server (
src/proxy.ts): WebSocket + Express server handling audio streaming and webhooks - Transcription Client (
src/gladia.ts): VoiceRouter SDK wrapper supporting multiple providers - TUI Visualizer (
src/audioVisualizer.ts): Real-time terminal dashboard - Transcript Logger (
src/transcriptLogger.ts): Session-based transcript storage
| Issue | Solution |
|---|---|
| 401 Unauthorized | Check your MeetingBaas API key in .env |
| No transcription | Verify transcription provider API key is valid |
| WebSocket errors | Ensure ngrok URL is correct and uses wss:// |
| Bot not joining | Check meeting URL is valid and accessible |
| TUI not displaying | Ensure terminal supports ANSI escape codes |
pnpm run dev:local # Local mode (proxy only)
pnpm run remote # Remote mode (MeetingBaas bot)
pnpm run build # Build TypeScript- Transcript Logging - Detailed transcript feature documentation
- Data Storage - Where and how data is stored
MIT