{"id":50874540,"url":"https://github.com/daviddao/murmur","last_synced_at":"2026-06-15T08:30:53.920Z","repository":{"id":364059983,"uuid":"1266180759","full_name":"daviddao/murmur","owner":"daviddao","description":"Hold right ⌘, speak, release — open-source local dictation for macOS (Parakeet on CoreML or ElevenLabs)","archived":false,"fork":false,"pushed_at":"2026-06-11T12:46:44.000Z","size":248,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T14:16:28.136Z","etag":null,"topics":["dictation","macos","parakeet","push-to-talk","speech-to-text","swiftui","whisper"],"latest_commit_sha":null,"homepage":"https://murmur-mac.vercel.app","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daviddao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-11T11:44:47.000Z","updated_at":"2026-06-11T12:47:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/daviddao/murmur","commit_stats":null,"previous_names":["daviddao/murmur"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/daviddao/murmur","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daviddao%2Fmurmur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daviddao%2Fmurmur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daviddao%2Fmurmur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daviddao%2Fmurmur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daviddao","download_url":"https://codeload.github.com/daviddao/murmur/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daviddao%2Fmurmur/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34355156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["dictation","macos","parakeet","push-to-talk","speech-to-text","swiftui","whisper"],"created_at":"2026-06-15T08:30:49.730Z","updated_at":"2026-06-15T08:30:53.915Z","avatar_url":"https://github.com/daviddao.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/icon.png\" width=\"128\" alt=\"Murmur icon\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eMurmur\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eHold right ⌘ · speak · release — your words appear wherever you're typing.\u003c/b\u003e\u003cbr\u003e\n  A tiny, open-source, superwhisper-style dictation app for macOS.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-14%2B-black?logo=apple\" alt=\"macOS 14+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Swift-5.10-orange?logo=swift\" alt=\"Swift\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/transcription-100%25%20local-brightgreen\" alt=\"Local\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"MIT\"\u003e\n\u003c/p\u003e\n\n---\n\nMurmur lives in your menu bar. Hold the right **⌘** key anywhere — in Mail, Slack,\nyour editor, a browser — and talk. Release the key and the transcribed text is\npasted right where your cursor is. That's the whole app.\n\n- 🪶 **Minimal** — a menu bar icon and a small floating waveform HUD. No windows, no accounts, no telemetry.\n- 🔒 **Local by default** — transcribes on-device with NVIDIA **Parakeet TDT 0.6B**\n  via Core ML ([FluidAudio](https://github.com/FluidInference/FluidAudio)).\n  Your audio never leaves your Mac. ~0.5 s warm-start on Apple Silicon.\n- ☁️ **Bring your own cloud (optional)** — switch the engine to **ElevenLabs Scribe**\n  and paste in your API key if you already pay for ElevenLabs.\n- ⌨️ **True push-to-talk** — hold right ⌘ (or right ⌥ / right ⌃). **Esc** cancels.\n  Regular ⌘-shortcuts keep working, even ones that use the right ⌘ key.\n- 📋 **Polite pasting** — inserts via ⌘V and restores whatever was on your clipboard afterwards.\n- 🌍 **25 languages** locally (Parakeet v3), or English-optimized (v2), or 90+ via ElevenLabs.\n\n## Install\n\nRequires macOS 14+ (Apple Silicon recommended).\n\n### Option 1 — Homebrew\n\n```bash\nbrew install --cask daviddao/tap/murmur\n```\n\n### Option 2 — download\n\nGrab **[Murmur.dmg](https://github.com/daviddao/murmur/releases/latest/download/Murmur.dmg)**\nfrom the latest release and drag Murmur into Applications.\n\n\u003e ⚠️ The build is not notarized (no Apple Developer subscription), so macOS warns\n\u003e on first open (Homebrew installs included). Go to\n\u003e **System Settings → Privacy \u0026 Security → Open Anyway**, or:\n\u003e ```bash\n\u003e xattr -d com.apple.quarantine /Applications/Murmur.app\n\u003e ```\n\n### Option 3 — build from source\n\nNeeds the Xcode command line tools (`xcode-select --install`).\n\n```bash\ngit clone https://github.com/daviddao/murmur.git\ncd murmur\nmake install        # builds Murmur.app and copies it to /Applications\nopen /Applications/Murmur.app\n```\n\nPrefer to try it first? `make run` launches it from the local `build/` folder.\n`make dmg` builds the drag-and-drop disk image.\n\n## First run\n\n1. **Microphone** — click *Allow* on the prompt.\n2. **Accessibility** — needed to detect the right ⌘ key globally and to paste.\n   System Settings → Privacy \u0026 Security → Accessibility → enable **Murmur**.\n3. The first launch downloads the Parakeet model (~470 MB) from Hugging Face\n   and caches it. The menu bar shows `Parakeet: ready` when done.\n4. Put your cursor in any text field, **hold right ⌘**, talk, release. ✨\n\n## Settings\n\nMenu bar icon → **Settings…**\n\n| Setting | Options |\n|---|---|\n| Hold to dictate | Right ⌘ (default) · right ⌥ · right ⌃ |\n| Engine | Parakeet (local, default) · ElevenLabs (cloud) |\n| Parakeet model | v3 multilingual (25 languages) · v2 English-only |\n| ElevenLabs | API key · Scribe v2/v1 · optional language hint |\n| Extras | Sounds on/off · launch at login |\n\n## How it works\n\n```\nright ⌘ down                      release\n     │                               │\nCGEventTap ──▶ AVAudioEngine ──▶ 16 kHz mono Float32 ──▶ Parakeet (Core ML)\n(flagsChanged)  (mic capture)                        └─▶ ElevenLabs Scribe API\n                                                              │\n                    your app ◀── synthetic ⌘V (clipboard restored) ◀── text\n```\n\nA floating, click-through `NSPanel` shows a live waveform while you speak and\nthe result when it lands. Everything is plain Swift + SwiftUI — no Electron,\nthe binary is ~8 MB.\n\n### Debug from the terminal\n\nThe app binary doubles as a CLI for testing the local engine:\n\n```bash\n.build/release/Murmur transcribe path/to/audio.wav\n```\n\n## Troubleshooting\n\n- **Nothing happens when I hold right ⌘** — check Accessibility permission.\n  After rebuilding from source, macOS may require you to toggle the grant\n  off/on again (the app is ad-hoc signed, so the signature changes per build).\n- **`Parakeet: preparing model…` for a long time** — first run downloads\n  ~470 MB from `huggingface.co`. Check your connection; it's cached afterwards in\n  `~/Library/Application Support/FluidAudio/`.\n- **Text appears in the wrong app** — the text is pasted into whatever app has\n  keyboard focus when transcription finishes.\n- **Esc** cancels a recording you didn't mean to start; taps shorter than\n  0.35 s are ignored.\n\n## Privacy\n\nWith the default Parakeet engine, audio is recorded to memory, transcribed\non-device, and discarded. Nothing is written to disk, nothing is sent anywhere.\nWith the ElevenLabs engine, audio is sent to the ElevenLabs API under your key\nand their [privacy terms](https://elevenlabs.io/privacy).\n\n## Acknowledgements\n\n- [FluidAudio](https://github.com/FluidInference/FluidAudio) — Parakeet TDT on Core ML, doing the heavy lifting\n- NVIDIA [Parakeet TDT 0.6B](https://huggingface.co/FluidInference/parakeet-tdt-0.6b-v3-coreml) — a remarkable little ASR model\n- [superwhisper](https://superwhisper.com) — the UX inspiration; if you want a polished, full-featured product, buy it!\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaviddao%2Fmurmur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaviddao%2Fmurmur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaviddao%2Fmurmur/lists"}