System requirements

✓macOS 13 (Ventura) or later for the core app — recording, local Whisper transcription, Raw and Clean writing styles.
✓macOS 26 or later, on Apple Intelligence–capable hardware, for the Polish and Formal writing styles, which use Apple’s on-device Foundation Models. On older systems or unsupported hardware, VybeScript automatically falls back to a deterministic cleanup instead of AI polish for those modes.
✓Apple Silicon recommended for best transcription speed (Whisper runs GPU-accelerated via Metal).

Getting started

VybeScript walks you through a guided setup the first time you open it:

  1. Download VybeScript and move it to your Applications folder.
  2. Open it and allow Microphone access when the guided setup asks — required to record.
  3. (Recommended) Enable Accessibility access when prompted, so VybeScript can paste transcripts directly into whatever app you’re using. If you skip this, transcripts go to your clipboard instead.
  4. Pick your dictation language and review your recording hotkeys (toggle and push-to-talk, both customizable).
  5. Add any custom vocabulary — names, jargon, product names — and choose a default writing style (Raw, Clean, Polish, or Formal). Both are optional and can be changed anytime in Settings.
  6. Activate your license — right after, VybeScript runs a one-time, few-second performance check on your Mac and shows you its speed tier (Fast/Good/Basic) before you start dictating for real. See “Why does VybeScript benchmark my Mac during setup?” in the FAQ for details.
  7. Press the toggle hotkey (default F6) to start/stop recording, or hold the push-to-talk key (default Control).

Activating your license

After purchase, Lemon Squeezy emails you a license key (format VYBE-XXXX-XXXX-XXXX). Open VybeScript’s License window (menu bar → License…) and paste it in, or click Activate. If you switch Macs later, use Deactivate this Mac on the old one first to free the slot. Activating triggers the one-time performance check described above.

Updating VybeScript

VybeScript checks for updates automatically in the background. You can also check manually anytime — either from the “Vybe” item in the menu bar (Check for Updates…) or from Settings → About in the main window. New versions install in place; you don’t need to re-download the DMG.

Troubleshooting

Nothing happens when I press the hotkey.

A few possibilities: the hotkey may conflict with another app’s shortcut — try one of the alternate presets (F7, F9, F10, F12, or Option+Shift+Space). It could also be one of the handful of combos macOS reserves for itself system-wide — Control+Space and Control+Option+Space (input source switching), Cmd+Space (Spotlight), Cmd+Tab (App Switcher), Cmd+Option+Esc (Force Quit), F3 (Mission Control), or Control+Arrow keys (Spaces/Mission Control). VybeScript detects these and shows a warning right in Settings explaining which system shortcut to change or turn off if you want to use that combo.

Transcript isn’t appearing where I’m typing.

Grant Accessibility permission (System Settings → Privacy & Security → Accessibility → enable VybeScript). Without it, the transcript is copied to your clipboard — paste manually with Cmd+V.

Polish/Formal says it needs Apple Intelligence.

Those two styles require macOS 26+ on supported hardware. Raw and Clean always work regardless.

Transcription seems inaccurate on names or jargon.

Add the term to your custom vocabulary in Settings — it biases recognition toward words you use often, and you can also teach direct heard→corrected substitutions.

License won’t activate / says invalid.

Double-check the key was copied without extra spaces. If it still fails, email us with your purchase email and we’ll sort it out.

How do I uninstall VybeScript?

Quit the app, then drag VybeScript from Applications to the Trash. To remove local data too (transcript history, vocabulary), also delete ~/Library/Application Support/VybeScript (this does not affect your Mac otherwise, and nothing is sent anywhere by doing this — it was always local).

Still need help?

Email hello@boxcreativestudio.com — include your macOS version and, if it’s a licensing issue, the email you purchased under. You can also check the full FAQ.