{"id":30144802,"url":"https://github.com/unclecode/tap2talk","last_synced_at":"2026-05-18T09:36:19.851Z","repository":{"id":312415754,"uuid":"1038517465","full_name":"unclecode/tap2talk","owner":"unclecode","description":"Voice transcription at your fingertips - Instantly convert speech to text with a simple keyboard shortcut","archived":false,"fork":false,"pushed_at":"2025-08-28T02:59:28.000Z","size":332,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-29T19:12:02.994Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://tap2talk.github.io","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unclecode.png","metadata":{},"created_at":"2025-08-15T10:53:01.000Z","updated_at":"2025-09-23T14:11:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"26670398-9515-45e2-896d-aa453eaa8e11","html_url":"https://github.com/unclecode/tap2talk","commit_stats":null,"previous_names":["unclecode/tap2talk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/unclecode/tap2talk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Ftap2talk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Ftap2talk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Ftap2talk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Ftap2talk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unclecode","download_url":"https://codeload.github.com/unclecode/tap2talk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Ftap2talk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33172735,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-11T08:02:36.926Z","updated_at":"2026-05-18T09:36:19.833Z","avatar_url":"https://github.com/unclecode.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tap2Talk\n\n```\n ████████╗  █████╗  ██████╗  ██████╗  ████████╗  █████╗  ██╗      ██╗  ██╗\n ╚══██╔══╝ ██╔══██╗ ██╔══██╗ ╚════██╗ ╚══██╔══╝ ██╔══██╗ ██║      ██║ ██╔╝\n    ██║    ███████║ ██████╔╝  █████╔╝    ██║    ███████║ ██║      █████╔╝ \n    ██║    ██╔══██║ ██╔═══╝  ██╔═══╝     ██║    ██╔══██║ ██║      ██╔═██╗ \n    ██║    ██║  ██║ ██║      ███████╗    ██║    ██║  ██║ ███████╗ ██║  ██╗\n    ╚═╝    ╚═╝  ╚═╝ ╚═╝      ╚══════╝    ╚═╝    ╚═╝  ╚═╝ ╚══════╝ ╚═╝  ╚═╝\n```\n\n**Talk in ANY app, type nothing.** Works everywhere you type - VSCode, Terminal, Slack, Browser, anywhere. Press a key, speak, and watch your words appear instantly where you're working.\n\n\u003e *\"I believe talking to computers is the future. With AI getting smarter, why are we still typing everything? I built Tap2Talk for myself because I wanted to speak naturally in ANY application without switching tools. Now I'm sharing it with you.\"* - [@unclecode](https://x.com/unclecode)\n\nBuilt by [@unclecode](https://x.com/unclecode), creator of [Crawl4AI](https://github.com/unclecode/crawl4ai) (50K+ stars).\n\n## Works Everywhere\n\n✅ **Code Editors** - VSCode, Sublime, Vim, IntelliJ, any IDE  \n✅ **Terminal** - Dictate complex commands without typing  \n✅ **Chat Apps** - Slack, Discord, Teams, WhatsApp Web  \n✅ **Browsers** - Gmail, ChatGPT, Google Docs, anywhere on the web  \n✅ **Note Taking** - Notion, Obsidian, Apple Notes, OneNote  \n✅ **Literally Anywhere** - If you can type there, you can talk there\n\n## Features\n\n- **One Shortcut for Everything**: Press `Ctrl+Space` (double-tap Space) to start recording anywhere\n- **Instant Paste**: Your words appear right where your cursor is - no copy/paste needed\n- **Powered by Groq Whisper**: Fast and accurate transcription using state-of-the-art AI\n- **Customizable Shortcuts**: Set your own recording and abort shortcuts\n- **Cross-Platform**: Works on macOS, Windows, and Linux\n- **Background Service**: Runs quietly in the background, always ready\n- **System Tray Integration**: Clean interface with status indicators\n\n## Groq API Setup\n\nTap2Talk currently uses Groq's lightning-fast Whisper API for transcription. Support for OpenAI Whisper, local models, and other providers coming soon!\n\n### Why Groq?\n- ✅ **Free tier available** - Perfect for personal use (30 requests/min, 14,400 requests/day)\n- ✅ **Blazing fast** - Near-instant transcription\n- ✅ **High accuracy** - Powered by Whisper Large v3\n- ✅ **No credit card required** - Start immediately\n\n### Get Your API Key (2 minutes)\n\n1. **Create Account**: Visit [console.groq.com](https://console.groq.com) and sign up with Google or GitHub\n2. **Generate API Key**: Navigate to \"API Keys\" → Click \"Create API Key\" → Name it \"Tap2Talk\"\n3. **Copy Your Key**: Copy the key (starts with `gsk_`) - Tap2Talk will ask for it on first run\n\nThe free tier includes 30 requests per minute and 14,400 requests per day - more than enough for regular use!\n\n### Coming Soon\n- OpenAI Whisper API support\n- Local Whisper models (no internet required)\n- Other transcription providers\n\n## Installation\n\n```bash\nnpm install -g tap2talk\n```\n\n## Quick Start\n\n1. **Run interactively** (recommended for first time):\n   ```bash\n   tap2talk\n   ```\n\n2. **Start as background service**:\n   ```bash\n   tap2talk start\n   ```\n\n3. **Check status**:\n   ```bash\n   tap2talk status\n   ```\n\n## Commands\n\n- `tap2talk` - Interactive mode with menu\n- `tap2talk start` - Start as background service\n- `tap2talk stop` - Stop background service\n- `tap2talk status` - Check service status\n- `tap2talk restart` - Restart service\n- `tap2talk logs` - Show recent logs\n- `tap2talk update` - Check for updates\n\n## Setup\n\nOn first run, you'll need to:\n\n1. Get a free API key from [Groq Console](https://console.groq.com/keys)\n2. Enter it when prompted\n3. Grant accessibility permissions (macOS) for global shortcuts\n\n## Default Shortcuts\n\n- **Start Recording**: `Ctrl+Space` (hold Ctrl, double-tap Space)\n- **Abort Recording**: Double-tap `Escape`\n\nBoth shortcuts are fully customizable in Settings.\n\n## How It Works\n\n1. Press your recording shortcut\n2. Speak naturally\n3. Recording stops automatically or press shortcut again\n4. Text is transcribed and pasted instantly\n\n## Status Indicators\n\nThe system tray shows real-time status:\n- `Tap` - Ready\n- `[*] REC` - Recording\n- `[~] PRO` - Processing\n- `[OK] DON` - Done\n- `[X] ERR` - Error\n- `[_] ABT` - Aborted\n\n## Configuration\n\nSettings are stored in `~/.tap2talk/config.json`\n\n## Requirements\n\n- Node.js 14 or higher\n- Groq API key (free)\n- Microphone access\n\n## Privacy\n\n- Audio is processed via Groq API\n- No audio is stored locally after transcription\n- Settings and logs stay on your machine\n\n## Troubleshooting\n\n### Service won't start\n```bash\ntap2talk stop\ntap2talk start\n```\n\n### Permission issues (macOS)\nGo to System Preferences → Security \u0026 Privacy → Privacy → Accessibility\nAdd and enable Terminal/iTerm\n\n### Check logs\n```bash\ntap2talk logs\n```\n\n## Contributing\n\nIssues and PRs welcome at [github.com/unclecode/tap2talk](https://github.com/unclecode/tap2talk)\n\n## License\n\nMIT © unclecode\n\n---\n\nBuilt with inspiration from productivity needs and powered by [Groq](https://groq.com) Whisper API.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclecode%2Ftap2talk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funclecode%2Ftap2talk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclecode%2Ftap2talk/lists"}