spaces-listener

Record, transcribe, and summarize X/Twitter Spaces — live or replays. Supports multiple concurrent recordings.

Commands

# Start recording (runs in background)
spaces listen <url>

# Record multiple Spaces at once
spaces listen ""
spaces listen ""

# List all active recordings
spaces list

# Check specific recording status
spaces status 1

# Stop a recording
spaces stop 1
spaces stop all

# Clean stale pid/meta files
spaces clean

# Transcribe when done
spaces transcribe ~/Desktop/space.m4a --model medium

# Summarize an existing transcript
spaces summarize ~/Desktop/space_transcript.txt

# Skip summarization
spaces transcribe ~/Desktop/space.m4a --no-summarize

Requirements

brew install yt-dlp ffmpeg openai-whisper

For summaries, set OPENAI_API_KEY (transcription still works without it).

How It Works

Each spaces listen starts a new background recording with a unique ID

Recordings persist even if you close terminal

Run spaces list to see all active recordings

When done, spaces stop or spaces stop all

Transcribe with spaces transcribe

Summaries are generated automatically after transcription (skip with --no-summarize)

Output

Files saved to --output dir (default: ~/Desktop):

• space__.m4a — audio


• space__.log — progress log


• space__.txt — transcript


• space___summary.txt — summary

Whisper Models

Model

Speed

Accuracy

tiny	⚡⚡⚡⚡	⭐
base	⚡⚡⚡	⭐⭐
small	⚡⚡	⭐⭐⭐
medium	⚡	⭐⭐⭐⭐
large	🐢	⭐⭐⭐⭐⭐