basilysf1709/golos

GitHub: basilysf1709/golos

Golos 是一款轻量级的 macOS 命令行语音转文字工具,通过快捷键录音并借助 Deepgram 实现实时语音转录,松开即自动粘贴到任意应用。

Stars: 54 | Forks: 1

Golos Mascot

Golos

语音转文字,即刻完成

一个极其轻量级的 Wispr Flow 替代方案。按住快捷键,说话,松开,你的话语就会被粘贴出来。
单一二进制文件。零冗余。真正为你工作的语音识别。

网站快速开始GitHub

platform license version language

## 什么是 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工具, 效率工具, 日志审计, 语音听写, 语音转写