🐸 SapoWhisper

Transcribe your voice to text with a keyboard shortcut.

A macOS menu bar app that instantly converts speech to text. Press ⌥ + Space, speak, and the text is automatically pasted wherever you're typing.

---

✨ Features

• 🎤 Instant transcription — Press the shortcut, speak, done
• 🔒 100% private — Local transcription option with WhisperKit (no internet needed)
• ☁️ Google Cloud Chirp 3 — Maximum accuracy with Google's latest STT model
• ⌨️ Auto-paste — Text is automatically pasted where you're typing
• 🌐 Bilingual — Supports Spanish and English
• 🎨 Visual overlay — Floating pill shows recording status with audio visualizer

---

🚀 Installation

Requirements

• macOS 13.0 (Ventura) or later
• Apple Silicon (M1/M2/M3/M4/M5) recommended

Steps

1. Download the latest version from Releases
2. Drag SapoWhisper.app to your Applications folder
3. Open the app — a 🐸 will appear in your menu bar
4. Grant microphone permissions when prompted

---

🎯 Usage

1. Press ⌥ + Space (Option + Space) — customizable in Settings
2. Speak — You'll see a floating pill with the audio equalizer
3. Press the shortcut again to stop
4. ✨ Text is automatically pasted

💡 You can change the shortcut in Settings → Hotkey

---

⚙️ Transcription Engines

Choose your preferred engine in Settings → Engine:

Apple Speech (Online)

• ☁️ Requires internet connection
• 📦 No download needed
• 🔄 Uses Apple's servers

WhisperKit (Local) — Recommended for privacy

• 🔒 100% offline — Your audio never leaves your Mac
• 📥 Models download automatically inside the app

Model	Size	Speed	Accuracy
Tiny	77 MB	Very fast	⭐⭐
Base	147 MB	Fast	⭐⭐⭐
Small ⭐	487 MB	Moderate	⭐⭐⭐⭐
Large V3	3.1 GB	Slow	⭐⭐⭐⭐⭐
Large V3 Turbo ⭐	3.2 GB	Fast	⭐⭐⭐⭐⭐

💡 Small and Large V3 Turbo are recommended for best balance.

Google Cloud (Online) — Best accuracy

• 🎯 Chirp 3 (V2) — Google's most accurate speech-to-text model
• 🔑 API Key (V1) — Simple alternative with latest_long model
• ☁️ Requires internet and a Google Cloud account

Chirp 3 Setup (Recommended)

# 1. Install gcloud CLI
brew install google-cloud-sdk

# 2. Authenticate
gcloud auth application-default login

SapoWhisper will automatically detect your credentials. That's it!

API Key Setup (Alternative)

1. Go to Google Cloud Console → APIs & Services → Credentials
2. Create an API Key and restrict it to Cloud Speech-to-Text API
3. Paste the key in SapoWhisper Settings → Engine → Google Cloud → API Key

---

🤝 Contributing

Contributions are welcome! If you find a bug or have an idea, open an Issue.

---

📄 License

MIT © StevenACZ