chough

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Installation

安装

Arch Linux:

paru -S chough-bin

macOS:

brew install --cask hyperpuncher/tap/chough

Windows:

winget install chough

Source:

go install github.com/hyperpuncher/chough/cmd/chough@latest

Requires:

ffmpeg

for audio/video support

Arch Linux：

paru -S chough-bin

macOS：

brew install --cask hyperpuncher/tap/chough

Windows：

winget install chough

源码安装：

go install github.com/hyperpuncher/chough/cmd/chough@latest

依赖：

ffmpeg

以支持音频/视频处理

Quick Reference

快速参考

bash

undefined

bash

undefined

Basic transcription (text to stdout)

基础转录（文本输出到标准输出）

chough audio.mp3

JSON with timestamps

带时间戳的JSON格式

chough -f json podcast.mp3 > transcript.json

WebVTT subtitles

WebVTT字幕格式

chough -f vtt -o subs.vtt video.mp4

Low memory (30s chunks)

低内存模式（30秒分片）

chough -c 30 audiobook.mp3

undefined

chough -c 30 audiobook.mp3

undefined

Flags

命令行参数

Flag	Description	Default
`-c, --chunk-size`	Chunk size in seconds	60
`-f, --format`	Output: text, json, vtt	text
`-o, --output`	Output file	stdout
`--version`	Show version	-

参数	说明	默认值
`-c, --chunk-size`	分片大小（秒）	60
`-f, --format`	输出格式：text、json、vtt	text
`-o, --output`	输出文件路径	标准输出
`--version`	显示版本信息	-

Chunk Size Guide

分片大小指南

15-30s: Low memory (~500MB), higher error rate
60s: Balanced (default) - ~1.6GB RAM

15-30秒：低内存占用（约500MB），错误率较高
60秒：平衡模式（默认）- 约1.6GB内存

Performance

性能表现

Duration	Time	Speed
15s	2.0s	7.4x realtime
1min	4.3s	14.1x realtime
5min	16.2s	18.5x realtime
30min	90.2s	19.9x realtime

时长	耗时	处理速度
15秒	2.0秒	7.4倍实时速度
1分钟	4.3秒	14.1倍实时速度
5分钟	16.2秒	18.5倍实时速度
30分钟	90.2秒	19.9倍实时速度

Troubleshooting

故障排查

Out of memory: Use

-c 30

-c 15

Model fails: Check internet, verify

$XDG_CACHE_HOME

is writable ffmpeg errors: Ensure ffmpeg is installed

内存不足： 使用

-c 30

或

-c 15

参数 模型加载失败： 检查网络连接，确认

$XDG_CACHE_HOME

目录可写入 ffmpeg错误： 确保已安装ffmpeg

Notes

注意事项

First run downloads ~650MB model to
```
$XDG_CACHE_HOME/chough/models
```
Auto-extracts audio from video files
Set
```
CHOUGH_MODEL
```
env var to use custom model path
VTT groups tokens into subtitle cues automatically

首次运行时会下载约650MB的模型到
```
$XDG_CACHE_HOME/chough/models
```
目录
自动从视频文件中提取音频
设置环境变量
```
CHOUGH_MODEL
```
可指定自定义模型路径
VTT格式会自动将分词结果分组为字幕片段

Docs

文档

GitHub

GitHub