Browse the Help Center. Step-by-step fixes, setup guides and answers about plans and privacy are in the Help Center.
System requirements
Getting started
VybeScript walks you through a guided setup the first time you open it:
- Download VybeScript and move it to your Applications folder.
- Open it and allow Microphone access when the guided setup asks — required to record.
- (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.
- Keep the dictation language on Auto (English and Spanish, detected from your words) or pick one language, and review your recording hotkeys (toggle and push-to-talk, both customizable).
- 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.
- 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.
- Hold the push-to-talk key (default Option) while you speak, or tap the toggle hotkey (default Control) to start/stop recording. You can change both in Settings.
Activating your license
After purchase, Lemon Squeezy emails you a license key (a key looks like 2f6c91e0-7a4b-4d3e-b8a1-5c0d9e3f7a12, an example, not a real key). 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. One license can be active on up to 3 devices, Macs and iPhones together. Bought VybeScript in the iPhone app instead? You do not need a key: see Using your iPhone purchase on your Mac. Activating triggers the one-time performance check described above.
Cancel your Yearly Pass
You can cancel online in under a minute with the self-service portal, no email or call needed. Go to the subscription portal, sign in with the email you bought with (Lemon Squeezy sends you a one-time sign-in link), and choose Cancel. You keep using VybeScript until the end of the period you paid for and you will not be charged again. The same link is in your Lemon Squeezy receipt email, and the app’s License window has a Manage subscription button. If you cannot get in, email hello@boxcreativestudio.com as a backup and we will help you cancel. A one-time Lifetime license or Trial has nothing to cancel.
Refunds
Full refund within 30 days, no questions asked, for Yearly, Lifetime and Team Pack bought on our website. Email hello@boxcreativestudio.com with the word “refund”. Plans bought in the iPhone app with the App Store are refunded by Apple instead (see VybeScript for iPhone); for the privacy guarantee on those, we give you a written statement for Apple and a free license of the same plan. The free trial costs nothing, so there is nothing to refund. See the Refund Policy.
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.
The app says Polish or Formal needs Apple Intelligence, or that Apple Intelligence is off.
Polish and Formal use Apple Intelligence (Clean and Raw do not). Open System Settings → Apple Intelligence & Siri and turn it on (the Open Settings button in the app goes straight there), then give its model a few minutes to download. VybeScript picks up the change as soon as you switch back to it. On macOS 15 or earlier, update to macOS 26 first. Apple Intelligence must also be available in your language and region. Raw, Clean and transcription work normally either way. If your Mac can’t run Apple Intelligence, email us within 30 days of purchase for a full refund.
Transcription seems inaccurate on names or jargon.
Teach VybeScript a direct heard→corrected substitution in Settings → Vocabulary (for example, “super base” → “Supabase”). Corrections and custom words work with both speech engines. With Parakeet, a small one-time download (about 100 MB) lets it listen for your words. Focused lists work best: a few dozen names and terms you actually say. To add many at once, use Import… and paste or drop a list — or start from one of the starter packs below.
Still wrong? Email the word to hello@boxcreativestudio.com. Within 48 hours you’ll get a fix: a correction to import or a vocabulary pack update. If it needs an app fix, it ships in the next release. That’s our Word-Fix Promise.
Vocabulary starter packs
Free word lists for common fields. Download one, then in VybeScript go to Settings → Vocabulary → Import… and choose the file (or paste its contents). You’ll see a preview before anything is added. Each pack is 60 entries or fewer, so there’s room left for your own words.
- Legal
- Real estate
- Finance & accounting
- Dev & AI tools
- Healthcare admin & billing
- Spanish & Miami names
Why can I only add 100 words?
VybeScript improves recognition by telling the transcriber which words to listen for, and there is a hard ceiling on how much it can be told. 100 words all fit; past that, extra words simply have no effect on what you dictate.
Before version 0.2.0 there was no limit shown, but the ceiling still applied — words past roughly the first 60 were being silently ignored. If you had built up a long list, that is why some of it never seemed to help. The limit now makes that visible instead of invisible: every word inside it is a word VybeScript is genuinely listening for.
If you already have more than 100 words (from before 0.2.0), VybeScript keeps them all and uses the first 100. Settings shows a warning with the number to remove, so the words you actually rely on are among the ones being used.
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. That removes the app itself (about 240 MB, including the Whisper engine and its small model). Some things stay on your Mac on purpose: the downloaded speech models (in ~/Library/Application Support/FluidAudio), your history, vocabulary and diagnostics (in ~/Library/Application Support/VybeScript), and your settings. Your license and trial count stay in your Mac’s Keychain, so a reinstall keeps them. Nothing is sent anywhere by deleting these files; they were always local. For the full list of folders and how to remove them, see How do I uninstall or reinstall VybeScript?
VybeScript for iPhone
VybeScript for iPhone is a keyboard with a mic button: you talk, it types, in any app. Your voice is turned into text on your iPhone and nothing you say or type is sent to us.
What you need
- An iPhone with iOS 17 or later.
- An internet connection once, the first time you open the app, to download the speech model (about 600 MB). After that, dictation works offline.
- Polish and Formal reword your text with Apple Intelligence where your iPhone supports it (for example, iPhone 15 Pro or newer with Apple Intelligence turned on). On other iPhones they still lay out lists, steps and sign-offs, and only the rewording is skipped.
Install the keyboard and turn on Allow Full Access
- Open VybeScript and follow the setup. Allow the microphone when asked.
- Open iPhone Settings → General → Keyboard → Keyboards → Add New Keyboard and choose VybeScript.
- Tap VybeScript in that list and turn on Allow Full Access, then go back to the app.
- In any app, tap a text box, press the globe key until you see the VybeScript keyboard, tap the mic, talk, and tap it again to finish. The text appears at the cursor after you stop.
Why Full Access? iOS only lets a keyboard talk to its own app when Full Access is on. VybeScript’s keyboard uses it only to tell the app “start” and “stop” and to receive your text back. iOS shows the same warning for every keyboard that asks, including that it “can use the network”; VybeScript’s keyboard contains no networking code, and it does not save or send what you type. Without Full Access the keyboard cannot reach the app. Details are in the Privacy Policy.
The first tap opens VybeScript. How do I go back?
After a break, the first tap on the mic opens the VybeScript app so it can start the microphone. iOS has no way for an app to send you back, so swipe right along the very bottom edge of the screen (the thin bar), or tap the small arrow in the top-left corner. Then tap the mic again.
The mic does not start, or nothing is typed.
- If the keyboard says “Allow Full Access to dictate”, turn Full Access on (see above).
- Open the VybeScript app, then go back and tap the mic again. If the microphone is off for VybeScript, turn it on in iPhone Settings → VybeScript.
- Another app or a phone call may be using the microphone. End it and try again.
- Password fields use iOS’s own keyboard, so VybeScript is not offered there.
- If it keeps happening, send us a problem report (below).
AirPods and other Bluetooth headphones
VybeScript uses whichever microphone your iPhone is using. If dictation stops after you connect, take out, or put back AirPods, open the VybeScript app and tap the mic again. If it still does not work, disconnect and reconnect the headphones, or switch Bluetooth off and on, and send a problem report if it keeps happening.
Free trial, plans, and entering a license key
- Free trial. The iPhone app is free to download. The trial lasts 14 days or 5,000 dictated words, whichever comes first, with no card and no account. It starts only when you tap Start your free 14-day trial, which the app offers at the end of setup and later under Home or Settings → License; the 14 days and the word count begin at that tap. When it ends, dictation stops until you choose a plan; nothing is deleted.
- Buy in the app. Settings → License shows the Yearly and Lifetime plans with the price from the App Store. Apple handles payment, renewal and refunds for these purchases. If the Lifetime Privacy Guarantee applies, see the Refund Policy.
- Restore purchases. On a new iPhone, or after reinstalling, open Settings → License and tap Restore purchases, signed in with the Apple account that bought the plan.
- Enter a license key. Bought VybeScript on our website? Open Settings → License, paste the key from your Lemon Squeezy email, and tap Activate. The same key works on your Mac and your iPhone. Activating, removing a key, and each time the app opens afterwards contact Lemon Squeezy’s license service (the key and an activation ID only; nothing you dictated).
- How the 3 devices work. One Lifetime license or Yearly Pass can be active on up to 3 devices, Macs and iPhones together. If you reach the limit, free a device first: on a Mac choose Deactivate this Mac in the License window; on an iPhone choose Remove key from this iPhone in Settings → License. Then activate the key on the new device. This pool is for license keys; a plan bought in the iPhone app with the App Store belongs to the Apple ID that bought it and is not counted here (see below).
- Refunds and cancelling. Plans bought on our website: see Refunds above. Plans bought in the iPhone app: refunds and cancellation are handled by Apple at reportaproblem.apple.com, and a subscription is cancelled in iPhone Settings → your name → Subscriptions. If Apple refunds a purchase, your Mac shows it the next time the iPhone app has run and the Mac checks; a Mac that already stored the unlock keeps working offline until it checks again.
Using your iPhone purchase on your Mac
A Lifetime license or Yearly Pass bought in the iPhone app with the App Store also unlocks VybeScript for Mac, at no extra cost. No license key is needed.
- Automatic. Sign in on your Mac with the same Apple ID that bought the plan, turn on iCloud Drive, and open VybeScript on the Mac. It unlocks by itself. (The iPhone app saves Apple’s signed purchase record to your iCloud; your Mac checks Apple’s signature on the Mac. It holds no audio and no text.)
- If iCloud is off or slow. In the iPhone app tap Copy Mac activation code (or the share icon, to send it by AirDrop, Messages or Mail). On the Mac open VybeScript → License → Bought VybeScript on your iPhone? → Paste from clipboard.
- Yearly Pass. If your Mac cannot see iCloud, you need a new code after each renewal.
- Apple ID. An App Store unlock belongs to the Apple ID that bought it, so the Mac must use that Apple ID. Family Sharing is not offered.
- Not the same as a website key. Licenses bought on our website (Lemon Squeezy) are separate and follow the refund policy above.
Send a problem report
In the iPhone app open Settings → Help and feedback → Send a problem report. You see the whole report before it is sent. It contains only technical codes, timings and numbers (such as the app and iOS version and what failed), never what you said or typed. You can also copy the log on that screen and email it to us.
Questions about the iPhone app: hello@boxcreativestudio.com. Please do not send us text you dictated.
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.