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

# Voice Armed

> Hands-free voice control for Mission Control and the Setups Table. Use the Hey Scanner wake phrase to apply filters, change markets, switch saved views, and navigate without leaving the chart.

<Note>
  Voice Armed is an experimental feature available to active subscribers, free-access users, beta testers, staff, and superusers. It is currently **desktop-only** — mobile and coarse-pointer devices do not show the navbar voice control and cannot arm voice mode.
</Note>

**Voice Armed** lets you drive the scanner with your voice while your hands are on the chart or away from the keyboard entirely. Once armed, the browser listens for the **Hey Scanner** wake phrase, then interprets the command that follows — applying filters, switching markets, navigating between Mission Control and Setups, or applying a saved view.

## Arming voice mode

Voice Armed is reachable from two places on Mission Control and the Setups Table:

<Steps>
  <Step title="Click the Voice Armed control in the navbar">
    The navbar exposes a Voice Armed button that toggles between **Voice Off**, **Allow Mic**, **Starting**, **Listening**, and **Voice Error** states. Click it once to request microphone permission. After the browser grants access, the button shifts to **Listening** and the scanner waits for the wake phrase.
  </Step>

  <Step title="Press the v hotkey">
    On any registered voice page, press **v** to arm voice mode without using the mouse. The hotkey ignores text inputs and selects, so it does not trigger while you are typing in a filter field.
  </Step>
</Steps>

The button label updates to reflect the current state at all times. While armed, heard transcripts and command feedback render directly in the navbar so you can confirm what the scanner thinks you said before it acts on it.

## Wake phrase

The default wake phrase is **Hey Scanner**. The scanner also accepts **A Scanner** and **Hay Scanner** as fallbacks, because some browser speech-recognition engines drop or mishear the leading "hey." When the wake phrase is detected, the next utterance is treated as a command.

Speak the wake phrase and the command in one breath — for example:

```text theme={null}
Hey Scanner, futures
Hey Scanner, show 15 minute setups
Hey Scanner, clear setup filters
Hey Scanner, apply saved view Momentum Weekly
Hey Scanner, take me to setups
```

A short bloop sound plays when a command is recognized so you know the scanner heard you without checking the screen.

## Deterministic Setups commands

Setups Table commands are matched against a deterministic vocabulary first, before any AI interpretation runs. That means the most common commands fire instantly and visibly with no AI roundtrip.

<AccordionGroup>
  <Accordion title="Market filters">
    Switch the market scope from voice with phrases like:

    * `Hey Scanner futures`
    * `Hey Scanner stocks`
    * `Hey Scanner crypto`
    * `Hey Scanner stocks and futures`
    * `Hey Scanner change market to stocks`
  </Accordion>

  <Accordion title="Timeframe filters">
    Apply timeframe filters with phrases like:

    * `Hey Scanner show 15 minute setups`
    * `Hey Scanner 15 minute in force`
    * `Hey Scanner monthly`
    * `Hey Scanner 12H`
  </Accordion>

  <Accordion title="Setup filters">
    Apply structural setup filters with phrases like:

    * `Hey Scanner 11 setups` (1-1 sequence)
    * `Hey Scanner 31 setups` (3-1 sequence)
    * `Hey Scanner inside bar setups`
    * `Hey Scanner 1-2D` / `Hey Scanner 1-2`
    * `Hey Scanner weekly hammers`
    * `Hey Scanner inside weeks`
  </Accordion>

  <Accordion title="Candle state filters">
    Set CC and shape filters with phrases like:

    * `Hey Scanner current candle 2 down green`
    * `Hey Scanner 2 down` / `Hey Scanner 2 up`
    * `Hey Scanner potential 3s` / `Hey Scanner p3` (failed-2 / P3 true)
  </Accordion>

  <Accordion title="Earnings filters">
    Toggle the Earnings advanced filter with:

    * `Hey Scanner setups with earnings`
    * `Hey Scanner no earnings`
  </Accordion>

  <Accordion title="Ticker group filters">
    Filter to common ticker groups with phrases like:

    * `Hey Scanner MAG 7`
    * `Hey Scanner S&P 500`
    * `Hey Scanner NASDAQ 100`
    * `Hey Scanner DOW 30`
    * `Hey Scanner ETFs`
    * `Hey Scanner SPDR sectors`
  </Accordion>

  <Accordion title="Saved views">
    Apply any saved view by name. The phrase is matched against the saved-view list visible on the current page:

    ```text theme={null}
    Hey Scanner apply saved view Momentum Weekly
    ```

    If the name does not match a saved view, the command is rejected and the heard transcript stays visible in the navbar so you can retry.
  </Accordion>

  <Accordion title="Clearing filters">
    Reset filters individually or as a group:

    * `Hey Scanner clear setup filters`
    * `Hey Scanner clear filters`
  </Accordion>
</AccordionGroup>

## Navigation commands

Voice Armed recognizes navigation phrases without an AI interpretation step:

```text theme={null}
Hey Scanner, take me to setups
Hey Scanner, go to setups page
Hey Scanner, switch to mission control
```

When a command navigates to a filtered URL, voice mode stays armed on the destination page and re-enters wake-listening automatically — you do not need to re-arm after every navigation.

## Staying armed

<AccordionGroup>
  <Accordion title="Across navigations">
    After a command navigates to a different page, voice mode re-arms on the new page using the page re-arm token. The navbar label returns to **Listening** without any extra clicks.
  </Accordion>

  <Accordion title="Through transient errors">
    Browser speech-recognition errors that the engine reports as recoverable do not drop you out of armed mode. The navbar stays on **Listening** and the error appears in the debug popup so you know what happened.
  </Accordion>

  <Accordion title="Across the v hotkey">
    Pressing **v** on a page that supports Voice Armed re-enters wake-listening even after a previous voice session ended. Pressing **v** while typing in a text input or select does nothing, so it cannot disrupt filter editing.
  </Accordion>
</AccordionGroup>

## Voice On/Off for Metrics Alerts

Mission Control's [Metrics Alerts](/scanner/mission-control#metrics-alerts-panel) panel exposes its own **Voice On/Off** mode independent of Voice Armed. When Metrics Voice is on, the scanner reads each new metric alert aloud — symbol, timeframe(s), and event — using metric-prefix pronunciations for **RVOL**, **ATR**, **RSI**, **ORB**, **IBAL**, and **VWAP**. Use this when you want to listen to alert flow during the session without watching the panel.

<Tip>
  Voice Armed does not share state with Metrics Voice — you can leave the metrics panel reading alerts aloud while you arm voice commands separately to apply filters or change markets.
</Tip>

## Troubleshooting

* **The button stays on Voice Off.** Click it once and accept the browser microphone permission. Voice Armed will not arm until the browser has granted access.
* **Commands are heard but ignored.** The deterministic vocabulary requires the wake phrase first. Open the on-page debug popup (visible while armed) to confirm whether the wake phrase was detected.
* **Commands seem stuck on a previous utterance.** Voice Armed ignores older cumulative browser speech-recognition results — wait for the next utterance and try again.
* **The button shows Voice Error.** This usually indicates the OpenAI Realtime client-secret response failed. Refresh the page and retry; subscription, beta, and staff entitlements all need to resolve before the secret request succeeds.