> ## 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.

# App-specific profiles

> Vox can behave differently depending on which app is in front.

Vox knows which app you are in. A profile lets you change its behaviour per app, so
dictating into a terminal does not have to work the same way as dictating into email.

## What a profile can change

Profiles currently change button mappings and the voice commands attached to those
mappings. They do not change vocabulary, punctuation, or dictation formatting.

## Creating a profile

<Steps>
  <Step title="Open Settings">
    Open Vox and select **Buttons**.
  </Step>

  <Step title="Add a profile and pick an app">
    Open the profile menu at the top of the Buttons view and choose **New Profile…**.
    Name the profile and choose whether to start with the stock mappings or duplicate
    another profile. Select a profile from the same menu to configure it, and click
    **Set as default** when it should be used everywhere without an app-specific match.
    To assign it to an app, click **Assign**, add the app, and choose the profile for
    that app.
  </Step>

  <Step title="Adjust the settings you want to differ">
    Anything you do not change falls back to your default settings.
  </Step>
</Steps>

## How Vox picks a profile

The profile follows the frontmost app. Switch apps and the profile switches with you,
with no action needed. If no profile matches the app you are in, your default settings
apply.

Profiles are assigned to apps, identified by their application bundle. A browser profile
therefore applies to the browser app, not to an individual website.

## Profiles worth setting up

<AccordionGroup>
  <Accordion title="Terminal or code editor">
    Turn off auto-capitalisation and auto-punctuation. Add your project names,
    function names, and CLI tools to the vocabulary.
  </Accordion>

  <Accordion title="Email">
    Leave punctuation on. This is where you want the most formatting help.
  </Accordion>

  <Accordion title="Slack or chat">
    There is no separate built-in chat profile. Create one only if you want different
    button mappings or voice commands for a chat app.
  </Accordion>
</AccordionGroup>

## Seeing which profile is active

The active profile is not shown while dictating. The default profile is used unless the
foreground app has a specific profile assigned.