Skip to main content
On first launch, Vox opens its onboarding guide automatically. If you dismissed it, open the main Vox window, click the ? button in the top right, and choose Restart onboarding. You can also follow this page without reopening onboarding; the normal location for each setting is included below.
Setting up an iPhone or iPad instead? See Set up Vox on your iPhone.

1. Turn on and connect

1

Hold the black button for 2 seconds

Release the button when Vox vibrates and shows a green light. Keep it in front of you rather than on your chest for now, so you can see the buttons and lights while you set up.
2

Hold the black button again, until the second vibration

Once Vox is on and shows the green light, hold the black button again and keep holding: one vibration comes first, then a second one about 5 seconds in. Release on the second vibration. Vox is now in pairing mode. Only needed the first time, or when adding a new device.
3

Pair it in Bluetooth settings

Open System Settings, then Bluetooth, and select Vox. Keep the device near your Mac.
More detail in Turning on and pairing. To add a device without onboarding, open Switch device at the bottom of Vox’s left sidebar, choose Manage Devices…, and click + Add Device. Then select Vox in System Settings → Bluetooth.

2. Allow accessibility access

This is how Vox types, edits, and runs shortcuts in your other apps. Without it, dictation has no way to put text into the app you are using. During onboarding, click Allow accessibility access. If onboarding is closed, open Vox and select Settings in the left sidebar. When the accessibility banner appears, click Open System Settings, then open Privacy & Security → Accessibility and enable Vox.
Grant this after moving Vox into your Applications folder. If you run it straight from the disk image or from Downloads, macOS treats it as a temporary copy and the permission will not stick. The app detects this and tells you to move it first.

3. Wear it

Like a necklace, tucked under your shirt so the silicone ring touches your skin.

4. Start dictating

With the default mapping, quick press the white button once, start speaking, and press again to submit. The text lands wherever your cursor is. It works the same way in any text field on your Mac. If you are not using the default mapping, open Buttons in the left sidebar, select the White button, and check its Press action. Set it to Start and stop dictation if needed.
You do not need to raise your voice. See Getting the best accuracy.

5. Try voice commands

Hold the grey button and say something like “Switch to last app”. The built-in catalogue is available during onboarding or from Buttons in the left sidebar. In that view, open the Voice commands card for the selected profile and choose the command count/button, then choose Built-in commands. The phrasing does not have to be exact. You can add your own later. See Voice commands.

6. Map your buttons

The defaults are good, but every button gesture is yours to change. Open Buttons in the left sidebar, select a button, and edit its Press, Double press, or Hold row. See Map shortcuts to your buttons.

7. Stream to other apps

Leave Use Vox in other apps on and Vox is available as a microphone to Superwhisper, Wispr Flow, Apple Voice Control, and anything else that lets you pick an input device. Outside onboarding, open Settings in the left sidebar, stay on Basic, and find Other apps → Use Vox in other apps.
Some apps hide virtual microphones. If Vox does not appear in one, set Vox as your Mac’s input device in System Settings instead. See Use Vox as a microphone anywhere on Mac.

FAQ

Open Settings in Vox’s left sidebar, stay on Basic, and find Other apps. Click Reload Vox audio driver, then Reload audio. If macOS also asks you to confirm a permission in Privacy & Security, follow that prompt too.