Installing the macOS client and updating
In brief
The Whisperer macOS client is a desktop overlay that listens to your call audio, keeps a live transcript, and suggests replies right on top of any video service (Zoom, Google Meet, Microsoft Teams, Telegram, Discord, and others). It's invisible during screen sharing and runs locally on your Mac.
The client ships as a .app file that you download from the web dashboard. Both Mac architectures are supported: Apple Silicon (M1/M2/M3 and newer) and Intel. This page covers where to get the right build, how to install it, what happens on first launch, and how to update.
When to use this
- You're installing Whisperer on a Mac for the first time.
- You're moving to a new computer or reinstalling the system.
- You've switched from an Intel Mac to Apple Silicon (or vice versa) and need a build for the other architecture.
- A new version is out and you want to update.
Step-by-step
- Sign in to the web dashboard. Open https://whisperer.cc, sign in to your account, and go to the downloads section —
/app/download. If you don't have an account yet, register first (see Registration and sign-in). - Pick the build for your Mac. The downloads page lists the available builds by platform — each with a version number and file size (the list is generated by the backend via
/v1/app/builds). Find your Mac's architecture: Apple menu → "About This Mac". If the "Chip" line shows Apple M1/M2/M3 or newer, get the Apple Silicon build; if it shows "Intel Processor", get the Intel build. - Download the file. Click the build you need and wait for the download to finish. The file lands in your Downloads folder.
- Install the app. Open the downloaded file and drag
Whisperer.appinto the Applications folder. This is the standard way to install a macOS app. - Launch Whisperer. Open the app from Launchpad or the Applications folder. On first launch, macOS may ask you to confirm opening an app downloaded from the internet — confirm it.
- Go through the permission wizard. On first start, the permission wizard (PermissionWizard) opens: it checks Microphone, Screen Recording, and Accessibility and walks you into System Settings. For details, see macOS permissions.
- Link the client to your account. Start sign-in in the app — a web page opens to pair the device. See Pairing the desktop client with your account.
Screenshots
📸 [Screenshot: the
/app/downloadpage in the web dashboard with the list of builds — version and size for Apple Silicon and Intel]
📸 [Screenshot: the "About This Mac" window showing the chip/processor for choosing the architecture]
📸 [Screenshot: dragging Whisperer.app into the Applications folder]
Common mistakes
- Downloaded a build for the wrong architecture. An Intel build on Apple Silicon (and vice versa) may run slowly or fail to launch. Always check the "Chip/Processor" line in "About This Mac".
- Running the app straight from the Downloads folder. Run it from the Applications folder — otherwise it's easy to get confused by multiple copies when updating.
- macOS blocks the app from opening. For an app from the internet, confirm opening it on first launch. Don't run suspicious copies — download only from
/app/download. - The client won't connect to your account. Downloading and installing don't grant access on their own: you need to pair the device with your account separately (see "Related articles" below).
Best practices
- Download the client only from the official web dashboard
/app/download— that's where builds come with verified version and size. - Keep the app in the Applications folder — that way updates and uninstalls behave predictably.
- Before an important call, make sure you're on the current version: check
/app/downloadand compare its version number with the one you have installed. - To update, download the latest build from
/app/downloadand replaceWhisperer.appin the Applications folder. Previously granted permissions and the account pairing usually carry over.