Install Help · 🍎 macOS (beta)
Installing HyperVoice on Mac
HyperVoice on Mac ships as a standard .dmg — drag it into Applications and you're done. This build is Apple Silicon (M1/M2/M3/M4) only and needs macOS 11 (Big Sur) or later.
On Windows? Windows install guide → · On Linux? Linux install guide →
TL;DR
- Open
HyperVoice_0.6.7_aarch64.dmgand drag HyperVoice into Applications. - First launch: double-click HyperVoice and click Open at the standard "downloaded from the Internet" confirmation.
- Grant Microphone + Accessibility when prompted, then press your hotkey and dictate.
Step 1 — Open the .dmg and drag to Applications
Grab the disk image from your dashboard, or directly from hypervoice.app/api/download/mac. It saves to ~/Downloads/ by default. Double-click HyperVoice_0.6.7_aarch64.dmg to mount it.
A window opens showing the HyperVoice icon and an Applications shortcut. Drag HyperVoice onto the Applications folder to install it. After it copies, eject the disk image (drag it to the Trash or click the ⏏ next to it in Finder) and launch HyperVoice from your Applications folder or Launchpad.
Step 2 — First launch: click Open
The first time you open HyperVoice, macOS shows a one-time confirmation that it's an app you downloaded from the internet. Click Open, and you're in — every launch after that is a normal double-click.
That's the whole step. HyperVoice is signed with an Apple Developer ID and notarized by Apple, so there's no "damaged" warning to work around and no Terminal command. And the trust still runs deeper than a signature: HyperVoice works entirely offline by default — your audio never leaves your Mac — the privacy policy is readable end-to-end, and you can reach a real person on Discord or by email.
Step 3 — Grant Microphone access
The first time you start a dictation, macOS asks for Microphone permission so HyperVoice can hear you. Click Allow. If you dismissed the prompt or need to turn it on later:
- Open System Settings → Privacy & Security → Microphone.
- Find HyperVoice in the list and turn its toggle on.
Speech-to-text still runs entirely on your Mac — the microphone permission just lets HyperVoice capture the audio; nothing is uploaded.
Step 4 — Grant Accessibility access
HyperVoice needs Accessibility permission to do the two things that make it useful system-wide: paste the transcribed text at your cursor in whatever app you're in, and listen for the global hotkey from anywhere. Without it, the app opens but the hotkey and auto-paste won't work.
- Open System Settings → Privacy & Security → Accessibility.
- Find HyperVoice in the list and turn its toggle on (you may need to unlock with Touch ID or your password first).
- If HyperVoice isn't listed, click the + button, navigate to Applications, and add HyperVoice manually.
After granting it, quit and reopen HyperVoice if the hotkey doesn't fire right away — macOS sometimes needs a relaunch to pick up the new permission.
Using it
First launch downloads a Whisper speech model (default Tiny English ~75 MB) and walks you through hotkey setup. After that, press your hotkey anywhere on your Mac and dictate — same flow as the Windows and Linux builds.
macOS known limitations (beta)
- Apple Silicon only. This v1 build is
aarch64(M-series). Intel Mac support isn't in this release. - Whisper engine only. The optional Parakeet engine (Settings → Dictation) is Windows-only because the underlying DirectML execution provider is a Windows API. Whisper handles all the same languages and runs GPU-accelerated on Apple Silicon.
- Beta-quality. The Mac build hasn't seen as much real-world testing as the Windows build. Hitting a bug? Email support@hypervoice.app or report it in HyperVoice Community — most issues get patched within a day or two.
Updating HyperVoice
HyperVoice has a built-in auto-updater — when a new version ships, you'll see a banner inside the app with a "Download & restart" button. The updater swaps the app in place and relaunches.
If you'd rather update manually, the dashboard always serves the latest disk image from hypervoice.app/api/download/mac — drag the new HyperVoice into Applications, replacing the old one, and you're done.
Still stuck?
Two fast paths to get unblocked:
- Ask in Discord — join the HyperVoice Community and drop a message in
#install-help. Mac questions answered fast — usually by the team or other users who've hit the same thing. - Email us — support@hypervoice.app. Include your macOS version (Apple menu → About This Mac) and any error message you saw.