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

# Installation

> Install Stenox and configure required permissions

"og:title": "Stenox Docs"

## Download Stenox

<Steps>
  <Step title="Download the app">
    Visit [stenox.app/download](https://stenox.app/download) and download the latest version.
  </Step>

  <Step title="Open the DMG file">
    Locate the downloaded DMG file in your Downloads folder and double-click to open it.
  </Step>

  <Step title="Drag to Applications">
    Drag the Stenox app icon to your Applications folder.
  </Step>

  <Step title="Launch Stenox">
    Open Stenox from your Applications folder or Launchpad.
  </Step>
</Steps>

## Required Permissions

Stenox requires two system permissions to function properly.

### Microphone Access

Stenox needs microphone access to capture your voice.

**You'll be prompted automatically on first launch:**

1. Click **OK** when the microphone permission dialog appears
2. If you accidentally deny access, go to **System Settings → Privacy & Security → Microphone**
3. Enable the toggle next to Stenox

### Accessibility Access

Stenox uses Accessibility API to insert text at your cursor position.

<Steps>
  <Step title="Open System Settings">
    The Stenox onboarding wizard will guide you to System Settings.
  </Step>

  <Step title="Navigate to Accessibility">
    Go to **Privacy & Security → Accessibility** in System Settings.
  </Step>

  <Step title="Click the lock to make changes">
    Click the lock icon at the bottom left and authenticate with Touch ID or password.
  </Step>

  <Step title="Enable Stenox">
    Find Stenox in the list and toggle it on. If Stenox isn't listed, click the **+** button to add it.
  </Step>

  <Step title="Return to Stenox">
    Go back to Stenox and continue through the onboarding wizard.
  </Step>
</Steps>

<Warning>
  Without Accessibility permission, Stenox cannot insert text into other applications. This permission is essential for core functionality.
</Warning>

## Initial Configuration

After granting permissions, you'll complete the onboarding wizard:

1. **Welcome Screen** - Overview of Stenox features
2. **Permission Setup** - Grant microphone and accessibility access
3. **Completion** - Learn about the default hotkey (Option+Space)

## What's Next?

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/first-dictation">
    Configure your first provider and learn the basics.
  </Card>

  <Card title="Your First Dictation" icon="microphone-lines" href="/first-dictation">
    Step-by-step guide to your first voice dictation.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Stenox doesn't appear in menu bar">
    * Make sure Stenox is running (check Activity Monitor)
    * Restart Stenox

    <Frame>
      <img src="https://mintcdn.com/gedeon-47098cf8/DQVJ8HbojnYzFx2v/images/menu-bar-example.png?fit=max&auto=format&n=DQVJ8HbojnYzFx2v&q=85&s=dec2324cb4f34f03134a0dd53965f77b" alt="Stenox in the macOS menu bar" width="1810" height="110" data-path="images/menu-bar-example.png" />
    </Frame>

    Look for the Stenox icon in your menu bar (top-right of your screen, near the clock). Click it to access the app.
  </Accordion>

  <Accordion title="Permission dialogs don't appear">
    If the permission prompts don't appear automatically:

    1. Open **System Settings → Privacy & Security → Accessibility**
    2. Click the lock icon to make changes
    3. If Stenox is in the list, **remove it** by selecting it and clicking the **−** button
    4. Click the **+** button and add Stenox from your Applications folder
    5. Ensure the toggle next to Stenox is **enabled**

    Repeat for **Privacy & Security → Microphone** if needed.

    <Frame>
      <img src="https://mintcdn.com/gedeon-47098cf8/DQVJ8HbojnYzFx2v/images/accessibility-settings.png?fit=max&auto=format&n=DQVJ8HbojnYzFx2v&q=85&s=6db34e5ad2635c22362616531bbf8a86" alt="Enable Stenox in Accessibility settings" width="876" height="690" data-path="images/accessibility-settings.png" />
    </Frame>
  </Accordion>

  <Accordion title="App crashes or shows errors">
    * Ensure you're running macOS 13.0 or later
    * Try switching to a different transcription or AI provider in Settings
    * If the issue persists, send us feedback directly from the app (see below)
  </Accordion>
</AccordionGroup>

<Tip>
  **Contacting support is easy!** If the issue isn't with recording itself, go to **Settings → About → Send Feedback**. Simply record your feedback with your voice, and it will be transcribed and sent to us automatically. You can also use the feedback hotkey (**Right ⌘ + Right ⌥**) from anywhere.
</Tip>

<Note>
  Need more help? Visit our [Troubleshooting](/guides/troubleshooting) guide or email [support@stenox.app](mailto:support@stenox.app)
</Note>