Keyboard Shortcut

A keyboard shortcut is the keyboard-driven sibling of voice activation: press a key combo anywhere on the page and the widget opens and starts listening, no click required — the same idea Wispr Flow uses on the desktop, brought to the browser.

Pro feature

Keyboard shortcuts are available on the Pro and Pay-as-you-go plans. See pricing.

#Turning it on

Configure it per project in the dashboard — open your project → Appearance → Keyboard Shortcut, click the field, and press the actual keys you want. There is no syntax to type or get wrong; the combo is recorded straight from a real key press.

A second, optional field sets a separate shortcut to stop the call. Leave it blank and the first shortcut toggles instead — press it once to start talking, press it again to stop.

#Setting it in code

The same two fields are plain ui options if you'd rather set them from code than the dashboard — useful for a shortcut that should ship with a specific build rather than be editable per project:

typescript

import { VoxideClient } from "@voxide/react";
 
const ai = new VoxideClient({
  publicKey: "vox_pub_...",
  ui: {
    hotkeyActivate: "alt+k",     // starts a voice session
    hotkeyDeactivate: "escape",  // ends it — omit to make hotkeyActivate a toggle
  },
});

Format: modifier names joined with +, ending in the trigger key — "alt+k", "control+shift+v", "meta+j", "escape". Modifiers are case-insensitive and accept aliases: control/ctrl, alt/option, meta/cmd/command.

#The first-time hint

The first time the widget ever loads on a visitor's browser with a shortcut configured, a small dismissible tip appears above the launcher — “Press Alt+K to talk.” It's remembered per browser, so it shows exactly once and never again, whether it's dismissed, times out on its own, or the visitor just navigates away.

Two real limits — not Voxide's choice

A shortcut only fires while the browser tab is focused. There is no true system-wide hotkey from a web page — that needs a native app or a browser extension. And the Fn key cannot be bound: it doesn't send a signal browsers can see on virtually any platform. Native apps like Wispr Flow can bind Fn because they hook the OS directly; a web page can't. Pick a modifier combo like Alt+K instead.

#Safe around forms

A shortcut that has no modifier — a bare letter on its own — only fires outside text inputs. Type that letter into any field on your site and nothing happens; the shortcut only takes over when the visitor isn't already typing somewhere. Modifier combos like Alt+K always fire, the same convention most apps use for their own shortcuts.

← Voice Activation Human Handoff →