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
Links
- - 🌐 Website: https://xiabb.lol
- 📦 GitHub: https://github.com/dyz2102/xiabb
- 📄 MIT License
技能名称: clawbb
详细描述:
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 GEMINI
APIKEY=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 许可证
