basilysf1709/golos
GitHub: basilysf1709/golos
Golos 是一款轻量级的 macOS 命令行语音转文字工具,通过快捷键录音并借助 Deepgram 实现实时语音转录,松开即自动粘贴到任意应用。
Stars: 54 | Forks: 1
Golos
语音转文字,即刻完成
一个极其轻量级的 Wispr Flow 替代方案。按住快捷键,说话,松开,你的话语就会被粘贴出来。
单一二进制文件。零冗余。真正为你工作的语音识别。
网站 •
快速开始 •
GitHub
## 什么是 Golos?
Golos(俄语意为“声音”)是一个免费、开源的 macOS CLI 工具,能将你的语音转换为文字,无论你的光标在哪里。按住快捷键开始录音,松开即可转录,结果会立即粘贴到当前聚焦的应用程序中。
**工作原理:**
1. **按住**你的快捷键(默认:`Right Option` 或 `Left Option`)开始录音
2. **说话** —— 音频实时流式传输到 [Deepgram Nova-3](https://deepgram.com),并在终端中显示实时转录文本
3. **松开** —— 最终的转录结果会通过 `Cmd+V` 粘贴到当前聚焦的应用程序中
**主要功能:**
- **按住说话** —— 没有常驻麦克风,只有在按住快捷键时才会录音
- **单一二进制文件** —— 无需 Electron、无需 GUI、无需后台服务
- **前台或后台模式** —— 交互式运行或使用 `golos -d` 守护进程化
- **实时反馈** —— 说话时实时显示 VU 表和临时转录文本
- **词典替换** —— 将口语词汇映射为文本(例如:说 "period" → `.`,"new line" → `\n`)
- **可配置的快捷键** —— `right_option`、`right_command`、`fn`、`f18` 或 `f19`
- **两种输出模式** —— 粘贴到聚焦的应用程序(`clipboard`)或打印到 `stdout` 以便通过管道传输
- **配置分层** —— 默认值 → 配置文件 → 环境变量 → CLI flags
## 安装
```
curl -fsSL https://raw.githubusercontent.com/basilysf1709/golos/main/install.sh | bash
```
## 权限
Golos 需要**辅助功能**权限来监听你的快捷键并粘贴转录内容。首次运行 Golos 后,macOS 会提示你授予访问权限:
1. 打开 **系统设置 → 隐私与安全性 → 辅助功能**
2. 为你的终端应用程序(例如 Terminal、iTerm2、Alacritty)开启开关
如果你跳过这一步,Golos 将无法检测快捷键或粘贴文本。
## 使用方法
```
golos setup # configure API key
golos # run in foreground
golos -d # run in background
golos --output stdout # output to stdout instead of clipboard
golos --hotkey cmd # override hotkey
golos stop # stop background process
```
## CLI 命令
| 命令 | 描述 |
|---------|-------------|
| `golos setup` | 配置 Deepgram API key |
| `golos` | 运行语音转文字(前台) |
| `golos -d` | 运行语音转文字(后台) |
| `golos stop` | 停止后台进程 |
| `golos add
` | 添加词典替换 |
| `golos delete ` | 删除词典条目 |
| `golos list` | 列出所有词典条目 |
| `golos import ` | 从 TOML 文件导入词典 |
### Flags
| Flag | 描述 |
|------|-------------|
| `-d`, `--detach` | 在后台运行 |
| `--output ` | 覆盖输出模式(`clipboard` 或 `stdout`) |
| `--hotkey ` | 覆盖快捷键 |
### 词典
管理应用于转录文本的词/短语替换:
```
golos add "period" "."
golos add "new line" "\n"
golos delete "period"
golos list
golos import dictionary.example.toml
```
## 配置
配置文件:`~/.config/golos/config.toml`
```
deepgram_api_key = "your-key"
hotkey = "right_option"
output_mode = "clipboard"
sample_rate = 16000
language = "en-US"
```
环境变量 `DEEPGRAM_API_KEY`、`GOLOS_OUTPUT` 和 `GOLOS_HOTKEY` 会覆盖配置值。
## 要求
macOS、一个 [Deepgram API key](https://console.deepgram.com),以及终端的辅助功能权限。标签:Deepgram, EVTX分析, Go, Python安全, Ruby工具, 效率工具, 日志审计, 语音听写, 语音转写