> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augmental.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Vox with Superwhisper

> Recommended settings for using Vox as the microphone and trigger for Superwhisper.

Superwhisper handles the transcription, Vox provides the microphone and the button.

<Steps>
  <Step title="Turn off Vox dictation">
    Otherwise both tools transcribe at once and you get the text twice. See
    [Use another dictation tool instead](/other-apps/external-dictation).
  </Step>

  <Step title="Set Vox as Superwhisper's microphone">
    In Superwhisper, open Settings and set the input device to Vox. See
    [Use Vox as a microphone anywhere](/other-apps/virtual-mic).
  </Step>

  <Step title="Find Superwhisper's activation hotkey">
    Superwhisper Settings shows the shortcut for each mode. Note the one you use most.
  </Step>

  <Step title="Map a Vox button to it">
    In Vox, open **Buttons** and set a press to send that shortcut. See
    [Map shortcuts to your buttons](/using-vox/button-shortcuts).
  </Step>
</Steps>

## Recommended settings

| Setting               | Where                 | Value                 |
| --------------------- | --------------------- | --------------------- |
| Vox dictation         | Vox Settings          | Off                   |
| Vox button press      | Vox Buttons tab       | Superwhisper's hotkey |
| Input device          | Superwhisper Settings | Vox                   |
| Vox noise suppression | Vox Settings          | Not user-facing       |

Superwhisper handles its own audio processing. Vox noise suppression is currently an
internal experiment and is not available as a user-facing setting. If it becomes
available, leave it off for the recommended setup or try it only when your environment
needs extra cleanup.

## Modes

Superwhisper has multiple modes with separate hotkeys. Vox has three gestures per button
across three buttons, so you can map several modes at once. A setup that works well:

| Gesture            | Mode                                                |
| ------------------ | --------------------------------------------------- |
| White press        | Your default dictation mode                         |
| White double press | Enter by default; configure another mode if needed  |
| Red press          | A second mode, for example an email or message mode |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Superwhisper records silence">
    Check that Vox is connected and that Superwhisper has microphone permission for
    the Vox input specifically.
  </Accordion>

  <Accordion title="The button does nothing">
    The hotkey has to match exactly. Reopen Superwhisper's settings, confirm the
    combination, and re-record it in Vox.
  </Accordion>

  <Accordion title="Text appears twice">
    Vox dictation is still on. Turn it off.
  </Accordion>
</AccordionGroup>