speech2type
Advanced tools
A minimal CLI tool that gives you quick voice typing in every Mac app.
Voice typing from your terminal.
A simple CLI tool that gives you fast voice typing in every Mac app. Instant speech-to-text from your terminal to your cursor with one hotkey - works with Claude Code, Cursor, and any macOS application.
It just works:
npm install -g speech2type && s2t start
npm install -g speech2type
# Start the application
# s2t or s2t start
s2t start
# Follow the setup wizard to:
# 1. Get your FREE Deepgram API key from https://deepgram.com
# 2. Configure your language preference (default: English)
# 3. Set up your hotkey (default: ⌘;)
# 4. Grant microphone and accessibility permissions
s2t start in your terminalThat's it! You now have voice typing in every Mac app.
Speech2Type requires two permissions that will be requested on first run:
Grant these permissions in System Settings → Privacy & Security for your terminal app from which you run Speech2Type!
s2t config
# Change hotkey combination (default: ⌘;)
s2t config --hotkey
# Select language for speech recognition (default: English)
s2t config --language
# Update your Deepgram API key (or set the DEEPGRAM_API_KEY environment variable)
s2t config --deepgram-api-key
Speech2Type supports 40+ languages including:
See supported languages for the up-to-date full list.
# Clone the repository
git clone https://github.com/gergomiklos/speech2type.git
cd speech2type
# Install dependencies
npm install
# Build Swift components
npm run build
# Run in development mode
npm run dev
speech2type/
├── bin/ # Executable scripts
│ └── speech2type # Main CLI entry point
├── src/ # JavaScript source code
│ ├── index.js # Main application logic
│ ├── config.js # Configuration management
│ └── services/ # Core services
│ ├── hotkey.js # Global hotkey management
│ ├── transcriber.js # Deepgram integration
│ └── typer.js # Text injection via osascript
| └── permission.js # macOS permission handling
├── data/ # Language data
│ └── languages.json # Supported languages
└── swift/ # Native Swift components
├── hotkey-manager.swift # Global hotkey capture
├── mic-recorder.swift # Audio recording
└── permission-checker.swift # System permissions
1. "Permission denied" errors
Grant microphone access to your terminal app in System Settings → Privacy & Security → Microphone
Grant accessibility access to your terminal app in System Settings → Privacy & Security → Accessibility
Important: the terminal app must be the one that is running Speech2Type. Common terminal apps: Terminal (built-in macOS terminal), Cursor (integrated in-app terminals), Warp, VS Code...
2. "Command not found: s2t"
npm install -g speech2type3. "Hotkey not working"
s2t config --hotkey4. "Text not appearing"
5. "Text not appearing in secure fields"
6. "How to get a Deepgram API key?"
Go to https://deepgram.com/
Sign up for a free account
Click on "API Keys"
Click on "Create API Key"
Copy the API key
Run s2t config --deepgram-api-key and paste the API key
The free tier includes more than 50 hours of credits. No credit card required.
FAQ: https://speech2type.com/faq
Run with debug output for troubleshooting:
DEBUG=1 s2t start
s2t --help)We welcome contributions! Here's how to get started:
git checkout -b feature/amazing-featureDeepgram provides real-time streaming, higher accuracy, wider language support with reasonable low cost and developer-friendly APIs, allowing Speech2Type to remain native and lightweight (Speech2Type is not affiliated with Deepgram).
This project is licensed under the MIT License - see the LICENSE file for details.
If Speech2Type helps your workflow, consider:
Speech2Type - If you can type there, you can speak there.
Official website: https://speech2type.com
Built with ❤️
FAQs
A minimal CLI tool that gives you quick voice typing in every Mac app.
The npm package speech2type receives a total of 5 weekly downloads. As such, speech2type popularity was classified as not popular.
We found that speech2type demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Four npm packages disguised as cryptographic tools steal developer credentials and send them to attacker-controlled Telegram infrastructure.
Security News
Ruby maintainers from Bundler and rbenv teams are building rv to bring Python uv's speed and unified tooling approach to Ruby development.
Security News
Following last week’s supply chain attack, Nx published findings on the GitHub Actions exploit and moved npm publishing to Trusted Publishers.