ClawBB (虾BB)

Hold Globe key. Speak. Text appears. Free voice-to-text built for Vibe Coding.

- 🆓 Free forever — Google Gemini free tier, 250 transcriptions/day
🌏 Bilingual — Mixed Chinese + English, perfect punctuation for AI prompts
🔴 Live streaming preview — See text appear as you speak (Gemini Live API)
⚡ 341KB pure Swift — Zero dependencies, macOS native
🧠 LLM engine — Not Whisper ASR. Gemini understands meaning, not just sound.
📖 Open source — MIT License, Apple Notarized

Install

Download the Apple Notarized DMG (app release v1.1.3): from GitHub Releases:

CODEBLOCK0

Verify checksum before opening:

CODEBLOCK1

Then open the DMG and drag XiaBB.app to Applications:

CODEBLOCK2

The app is signed with Developer ID and Apple Notarized — no Gatekeeper warnings.

Build from source (optional)

If you prefer to inspect and compile yourself:

CODEBLOCK3

Requires Xcode Command Line Tools (xcode-select --install).

Setup

Gemini API Key

Get a free key at https://aistudio.google.com/apikey, then configure:

CODEBLOCK4

Or configure via the app's menu bar → "Configure Gemini API Key...".

The key is stored locally at ~/Tools/xiabb/.api-key (chmod 600 recommended).

Permissions

On first launch, macOS will prompt for:

- Accessibility: Required for Globe key detection (CGEventTap)
Microphone: Required for voice recording

Both are standard macOS permissions for a voice input app. Grant them in System Settings → Privacy & Security.

Usage

Action	Result
Hold 🌐 Globe key	Start recording, HUD shows live preview
Release 🌐 Globe key

Transcription pastes at cursor | | Click HUD 📋 | Copy last result |

Security & Privacy

- Open source: Full source at https://github.com/dyz2102/xiabb — review before use
Apple Notarized: Signed with Developer ID, verified by Apple
No account required: No signup, no tracking, no telemetry
Audio processing: Audio is sent to Google Gemini API for transcription. Review Google's privacy policy if this concerns you.
Local storage only: API key and config stored locally, never transmitted except to Gemini API

ClawBB (虾BB)

按住地球键。说话。文字出现。 专为 Vibe Coding 打造的免费语音转文字工具。

- 🆓 永久免费 — 使用 Google Gemini 免费套餐，每天 250 次转录
🌏 双语支持 — 中英文混合输入，为 AI 提示词提供完美标点
🔴 实时流式预览 — 说话时文字即时显示（Gemini Live API）
⚡ 341KB 纯 Swift 编写 — 零依赖，macOS 原生应用
🧠 LLM 引擎 — 非 Whisper ASR。Gemini 理解语义，而不仅仅是声音。
📖 开源 — MIT 许可证，已通过 Apple 公证

安装

从 GitHub Releases 下载已通过 Apple 公证的 DMG（应用版本 v1.1.3）：

bash
curl -L -o /tmp/XiaBB.dmg https://github.com/dyz2102/xiabb/releases/download/v1.1.3/XiaBB-v1.1.3-macOS-arm64.dmg

打开前验证校验和：

bash
echo ce53a5b0ccc3b0993b284686ab05716f3e616969f98395d1baf8aec083f8d784 /tmp/XiaBB.dmg | shasum -a 256 -c

然后打开 DMG 并将 XiaBB.app 拖到应用程序文件夹：

bash
open /tmp/XiaBB.dmg

该应用已使用开发者 ID 签名并通过 Apple 公证 — 不会出现 Gatekeeper 警告。

从源码构建（可选）

如果你希望自行检查并编译：

bash
git clone https://github.com/dyz2102/xiabb.git /tmp/xiabb-build
cd /tmp/xiabb-build

运行前请先查看 install.sh 和 native/main.swift

cat install.sh
bash install.sh

需要 Xcode 命令行工具（xcode-select --install）。

设置

Gemini API 密钥

在 https://aistudio.google.com/apikey 获取免费密钥，然后进行配置：

bash

推荐：使用环境变量

export GEMINIAPIKEY=your-key-here

或者通过应用菜单栏 → Configure Gemini API Key... 进行配置。

密钥本地存储在 ~/Tools/xiabb/.api-key（建议设置权限为 chmod 600）。

权限

首次启动时，macOS 会提示授予以下权限：

- 辅助功能：用于检测地球键（CGEventTap）
麦克风：用于语音录制

这些都是语音输入应用的标准 macOS 权限。请在系统设置 → 隐私与安全性中授予。

使用方法

操作	结果
按住 🌐 地球键	开始录制，HUD 显示实时预览
松开 🌐 地球键

转录内容粘贴到光标位置 | | 点击 HUD 📋 | 复制上一次结果 |

安全与隐私

- 开源：完整源码位于 https://github.com/dyz2102/xiabb — 使用前请自行审查
Apple 公证：使用开发者 ID 签名，经 Apple 验证
无需账户：无需注册，无追踪，无遥测
音频处理：音频发送至 Google Gemini API 进行转录。如有顾虑，请查阅 Google 的隐私政策。
仅本地存储：API 密钥和配置存储在本地，除发送至 Gemini API 外绝不传输

链接

- 🌐 网站：https://xiabb.lol
📦 GitHub：https://github.com/dyz2102/xiabb
📄 MIT 许可证

clawbbClawBB语音输入

clawbb

ClawBB (虾BB)