wavo

Browse and transcribe WhatsApp voice notes from the terminal.

Lists the most recent voice notes people have sent you across all chats, and transcribes any of them on demand with whisper.cpp running on Metal. Transcripts and decrypted audio are cached permanently, so a note stays readable long after WhatsApp expires the media off its servers.

The list updates on its own as new voice notes land in the bridge store; press R to refresh on demand.

Requirements

• The whatsapp-mcp Go bridge, running and logged in. wavo reads its SQLite store read-only and never writes to it.
• ffmpeg on PATH.
• A GGML whisper model, offered as a download on first run.

Usage

wavo                  # 50 most recent received voice notes
wavo --limit 200
wavo --lang auto      # default: pt
wavo --from "Ana"
wavo --store /path/to/whatsapp-bridge/store

By default wavo looks for the bridge store at ~/whatsapp-mcp/whatsapp-bridge/store; override it with --store.

Keys

Key	Action
↑ ↓	Move
⏎	Transcribe
r	Re-transcribe
/	Filter by sender
y	Copy transcript
R	Refresh the list
q	Quit

Building from source

git clone https://github.com/pdrgds/wavo
cd wavo
cargo build --release

The binary is written to target/release/wavo. The first build compiles whisper.cpp (with Metal) and takes a couple of minutes.

License

MIT