{"id":46695912,"url":"https://github.com/andyhtran/miniwhisper","last_synced_at":"2026-04-07T05:04:16.416Z","repository":{"id":343042259,"uuid":"1175071259","full_name":"andyhtran/MiniWhisper","owner":"andyhtran","description":"Minimal macOS menu bar app for voice-to-text dictation. On-device speech recognition powered by Parakeet — nothing leaves your Mac.","archived":false,"fork":false,"pushed_at":"2026-03-08T19:57:56.000Z","size":1154,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-11T10:59:07.959Z","etag":null,"topics":["apple-silicon","dictation","macos","menu-bar","on-device","parakeet-mlx","speech-to-text","stt","swift","transcription","voice-to-text","whisper"],"latest_commit_sha":null,"homepage":null,"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/andyhtran.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":null,"dco":null,"cla":null}},"created_at":"2026-03-07T07:23:47.000Z","updated_at":"2026-03-10T15:24:47.000Z","dependencies_parsed_at":"2026-03-10T06:00:34.158Z","dependency_job_id":null,"html_url":"https://github.com/andyhtran/MiniWhisper","commit_stats":null,"previous_names":["andyhtran/miniwhisper"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/andyhtran/MiniWhisper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyhtran%2FMiniWhisper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyhtran%2FMiniWhisper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyhtran%2FMiniWhisper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyhtran%2FMiniWhisper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andyhtran","download_url":"https://codeload.github.com/andyhtran/MiniWhisper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andyhtran%2FMiniWhisper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30419274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-12T07:30:13.030Z","status":"ssl_error","status_checked_at":"2026-03-12T07:29:54.885Z","response_time":114,"last_error":"SSL_read: 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":["apple-silicon","dictation","macos","menu-bar","on-device","parakeet-mlx","speech-to-text","stt","swift","transcription","voice-to-text","whisper"],"created_at":"2026-03-09T05:06:39.722Z","updated_at":"2026-04-03T05:04:17.056Z","avatar_url":"https://github.com/andyhtran.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MiniWhisper\n\nA minimal macOS menu bar app for voice-to-text with fast English transcription via [Parakeet](https://github.com/FluidInference/FluidAudio) and multilingual transcription via [whisper.cpp](https://github.com/ggml-org/whisper.cpp). Press a hotkey, speak, and the transcription is automatically pasted into the active app.\n\n![macOS 14.0+](https://img.shields.io/badge/macOS-14.0%2B-blue)\n![Swift 6.0+](https://img.shields.io/badge/Swift-6.0%2B-orange)\n![License MIT](https://img.shields.io/github/license/andyhtran/MiniWhisper)\n![GitHub release](https://img.shields.io/github/v/release/andyhtran/MiniWhisper)\n\n[Getting Started](#getting-started) · [Features](#features) · [Build](#build-commands)\n\n\u003cimg src=\".github/screenshot.png\" alt=\"MiniWhisper screenshot\" width=\"320\"\u003e\n\n## Getting Started\n\n1. [**Download MiniWhisper**](https://github.com/andyhtran/MiniWhisper/releases/latest/download/MiniWhisper.dmg)\n2. Open the DMG and drag the app to your Applications folder\n3. Launch MiniWhisper from Applications (or search \"MiniWhisper\" in Spotlight)\n4. Grant microphone and accessibility permissions when prompted\n5. Look for the MiniWhisper icon in your menu bar (top-right of your screen)\n6. Press **Option + `** to start recording, press it again to stop — the transcription is pasted into the frontmost app\n\nPress **Escape** to cancel a recording. To change the hotkey, click the MiniWhisper icon in the menu bar and set a new shortcut (e.g. **Fn**).\n\n\u003cdetails\u003e\n\u003csummary\u003eOther install methods\u003c/summary\u003e\n\n### Homebrew\n\n```bash\nbrew tap andyhtran/tap\nbrew install --cask miniwhisper\n```\n\n### Build from source\n\nRequires macOS 14+ (Sonoma) and Swift 6+.\n\n```bash\ngit clone https://github.com/andyhtran/MiniWhisper.git\ncd MiniWhisper\njust dev\n```\n\n\u003c/details\u003e\n\n## Features\n\n- **Auto-paste** — transcriptions go straight into whatever app you're using\n- **Customizable hotkey** — change the toggle shortcut from the menu bar panel\n- **Text replacements** — auto-correct words or phrases after transcription\n- **Recording history** — browse and copy recent transcriptions\n- **Usage stats** — track recordings, speaking time, word count, and average WPM\n- **Multiple models** — switch between fast English-only (Parakeet) and multilingual auto-detect (whisper.cpp)\n- **On-device** — all processing happens locally on your Mac, nothing leaves your device\n\n## Build commands\n\n```bash\njust dev          # Build, package, and launch\njust build        # Debug build only\njust release      # Release build + .app bundle\njust debug-tool   # Build local debug transcription CLI\njust clean        # Remove build artifacts\n```\n\nRun the local debug CLI on an existing audio file or recording directory:\n\n```bash\njust debug-transcribe ~/Code/debug-stt/whisper_cpp.wav --engine whisper --preset current-app\n```\n\n## Release\n\nSigning, notarization, and publishing require [`asc`](https://github.com/rudrankriyam/App-Store-Connect-CLI):\n\n```bash\nbrew install asc\n```\n\nSee `just --list` for the full set of release recipes (`sign-and-notarize`, `github-release`, `publish`, etc.).\n\n## Configuration\n\nCopy `.envrc.example` to `.envrc` and fill in your values. If using [direnv](https://direnv.net/), run `direnv allow`.\n\nFor local development, ad-hoc signing works out of the box — no Apple Developer account needed.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandyhtran%2Fminiwhisper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandyhtran%2Fminiwhisper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandyhtran%2Fminiwhisper/lists"}