whisnap

使用 whisnap 从终端转录音频/视频文件。需安装 Whisnap macOS 应用，并至少下载一个模型。

初始化设置（仅需一次）

• 打开 Whisnap 应用 → 设置 → 高级 → 启用 CLI（将创建符号链接 /usr/local/bin/whisnap）
• 在应用中至少下载一个 Whisper 模型

常用命令

• 转录音频：whisnap recording.wav
• 转录视频：whisnap meeting.mp4
• 云端转录：whisnap recording.wav --cloud
• 带时间戳的 JSON 输出：whisnap lecture.m4a --json
• 指定模型：whisnap interview.wav -m small-q5_1
• 云端 + JSON：whisnap recording.wav --cloud --json
• 列出已下载模型：whisnap --list-models
• 详细诊断信息：whisnap recording.wav -v

支持的格式

• 音频：WAV、MP3、FLAC、M4A、OGG
• 视频：MP4、MOV、MKV、WebM

参数选项

• -c, --cloud — 使用 Whisnap Cloud 而非本地模型（需先登录）
• -m, --model — 覆盖默认模型（例如 small-q5_1），默认使用应用中选定的模型
• -j, --json — 输出结构化 JSON，包含文本、分段、时间戳及模型信息
• -v, --verbose — 将进度和诊断信息输出到 stderr
• --list-models — 列出可用模型后退出

JSON 输出格式

{
  "text": "转录后的文本",
  "segments": [{ "start_ms": 0, "end_ms": 1000, "text": "分段内容" }],
  "model": "small-q5_1",
  "backend": "whisper",
  "processing_time_ms": 5000
}

注意事项

• CLI 复用 Whisnap 应用中的模型与设置（路径为 ~/Library/Application Support/com.whisnap.desktop/）。
• 云端模式需身份验证 —— 请先通过应用完成登录。
• 脚本调用时建议使用 --json 并对 stdout 进行管道处理；诊断信息输出至 stderr。
• 退出码 0 表示成功，1 表示出错。
• CLI 模式仅支持 Whisper 模型（不支持 Parakeet）。
• 执行转录前请确认文件路径有效 —— CLI 会校验路径，但不会自动搜索文件。