✓ Verified
💻 Development
✓ Enhanced Data
Whisnap
macOS CLI for transcribing audio and video files using local Whisper models or Whisnap Cloud.
- Rating
- 4.7 (340 reviews)
- Downloads
- 3,330 downloads
- Version
- 1.0.0
Overview
macOS CLI for transcribing audio and video files using local Whisper models or Whisnap Cloud.
Complete Documentation
View Source →
whisnap
Use whisnap for transcribing audio/video files from the terminal. Requires the Whisnap macOS app with at least one model downloaded.
Setup (once)
- Open Whisnap app → Settings → Advanced → Enable CLI (creates
/usr/local/bin/whisnapsymlink) - Download at least one Whisper model in the app
- Transcribe audio:
whisnap recording.wav - Transcribe video:
whisnap meeting.mp4 - Cloud transcription:
whisnap recording.wav --cloud - JSON output with timestamps:
whisnap lecture.m4a --json - Specific model:
whisnap interview.wav -m small-q5_1 - Cloud + JSON:
whisnap recording.wav --cloud --json - List downloaded models:
whisnap --list-models - Verbose diagnostics:
whisnap recording.wav -v
- Audio: WAV, MP3, FLAC, M4A, OGG
- Video: MP4, MOV, MKV, WebM
-c, --cloud— Use Whisnap Cloud instead of local model (requires sign-in)-m, --model— Override model (e.g.,small-q5_1). Defaults to app's selected model.-j, --json— Structured JSON output with text, segments, timestamps, model info-v, --verbose— Print progress and diagnostics to stderr--list-models— List available models and exit
json
{
"text": "transcribed text",
"segments": [{ "start_ms": 0, "end_ms": 1000, "text": "segment" }],
"model": "small-q5_1",
"backend": "whisper",
"processing_time_ms": 5000
}
Notes
- The CLI reuses models and settings from the Whisnap app (
~/Library/Application Support/com.whisnap.desktop/). - Cloud mode requires authentication — sign in via the app first.
- For scripting, use
--jsonand pipe stdout. Diagnostics go to stderr. - Exit code
0= success,1= error. - Only Whisper models are supported in CLI mode (not Parakeet).
- Confirm the file path exists before transcribing — the CLI validates but does not search.
Installation
Terminal bash
openclaw install whisnap
Copied!
💻Code Examples
JSON output format
json-output-format.json
{
"text": "transcribed text",
"segments": [{ "start_ms": 0, "end_ms": 1000, "text": "segment" }],
"model": "small-q5_1",
"backend": "whisper",
"processing_time_ms": 5000
}Tags
#coding_agents-and-ides
#cli
Quick Info
Category Development
Model Claude 3.5
Complexity One-Click
Author neolio42
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
Ready to Install?
Get started with this skill in seconds
openclaw install whisnap
Related Skills
✓ Verified
💻 Development
4claw
4claw — a moderated imageboard for AI agents.
🧠 Claude-Ready
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified
💻 Development
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
🧠 Claude-Ready
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified
💻 Development
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
⚡ GPT-Optimized
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified
💻 Development
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.
🧠 Claude-Ready
)}
★ 4.7 (88)
↓ 1,625
v1.0.0