In short
A voice command is a phrase you say while dictating. KortShut runs it instead of typing your words, for example to open an app.
When it helps
Use a command for something you do many times a day, when your hands are busy or the mouse is far away. Some examples:
- Open an app. Say "open my calendar", and Calendar comes to the front.
- Open a page or start an email. Say "open my inbox" to open your mail in the browser. Or say "email Sam" to start an email to the address you saved in the command.
- Run one of your Kortshuts (AI shortcuts). Highlight a message and say "make it polite".
- Run a shortcut from the Mac's Shortcuts app. Say "start my focus mode".
- Press keys in the app you are using. Say "next tab". This needs the Accessibility permission. See The permissions KortShut asks for, and why.
- Ask Kortney (the AI assistant). Say "write a thank-you note", and the answer is copied, ready to paste. Pick Paste at cursor in the command to have it typed where you are instead. This uses credits each time.
- Run a script (a short list of steps for your Mac, written by Kortney). Say "move today's screenshots to Archive".
A phrase is two to eight words. Say it on its own, with nothing before or after. If you say anything more, KortShut types your words as usual.
Make one
- Click the KortShut icon in the menu bar, and choose Open KortShut.
- In the sidebar (the list of pages in the window), click Dictation.
- Click the Commands tab, then click New command.
- In What should happen?, say or type what you want.
- Click Create with Kortney. Kortney needs the free trial or a subscription.
- Check the card Kortney shows, then click Save.
No trial? On the Commands tab, in the new command window, click Advanced to set up an app, a link, keys or a shortcut yourself. That is free.
To learn it by doing it, try the lesson: in the KortShut window, click Learn, then click Start lesson on Open an app by saying a phrase.
Make one from something you copied
To use the whole clip:
- In Klipboard, hold Control and click the clip. Or highlight the clip, and press Control- Return.
- In the menu, choose the line that starts with Make a voice command.
To use only some words:
- In Klipboard, click the clip. It shows in the preview.
- Drag across the words you want. Then hold Control and click them.
- In the menu, choose the line that starts with Make a voice command.
A window opens. It says Filled in from your Klipboard. Check it before you save. If the words box is empty, type 2 to 8 words you will say. If you chose the words, say what should happen. Without the trial, you choose what happens yourself. Then click Save.
The menu shows up to two lines, whichever fit:
- Words: Make a voice command with these words…
- A link: Make a voice command to open this link…. With several links, it says …to open a link…, then asks Which link should it open?.
- An email address: Make a voice command to email this address…
- An app: Make a voice command to open (app name)…, or …to open this app… for a long name.
- A Shortcut: Make a voice command to run this Shortcut…
- Keys, such as "Command-Shift-K": Make a voice command to press these keys…
It works in the Klipboard over other apps too.
A new command starts in Testing, unless you tick Make it Live now. A link with a password or key in it shows a warning.
There's no line for a picture, other files, a login token or several clips.
Testing and Live
A new command starts in Testing. When you say it, KortShut types your words as usual, and adds one line to the Test log. The log is on the Commands tab, and it stays on this Mac. Click Clear to empty it.
When the log shows what you wanted, switch the command to Live, which means it really runs.
To skip Testing, tick Make it Live now before you click Save. It is off each time, and it is on the New command window only. A script can be Live only after you click Test run and it passes. To go back, click Back to Testing.
Live is set on each Mac. If you change a command, or it arrives from another Mac, it goes back to Testing on that Mac.
Scripts and safety
Kortney writes a script once. You can read it with See exactly what runs, but you can't edit it. A change means a new draft, which is checked again.
- Before it can go Live, click Test run. A test runs for real, on each Mac.
- On a second Mac, the command says Needs review on this Mac. On its row, click Test run. Or click Edit command, read the script, click Test run, then click Save.
- A script that only reads and shows things says Read-only on its card, and runs without asking.
- A script that can change things shows Asks first. The pill (the small bar on your screen) asks before every run. Every zsh script is one of these, because KortShut can't be sure a zsh script only reads. The exception is a script you turned Don’t ask again for this command on, after a passing test.
- When the pill asks, tap your Dictation shortcut (to see it, click the KortShut icon in the menu bar, and choose Keyboard Shortcuts) once within 5 seconds to run the script. To stop it, click Don’t run. If you do nothing, it doesn’t run.
- A script's answer is never typed. It shows in the Test run result, in History on the Dictation page, and in Activity on the Dashboard.
- A script reads your keychain only if you turn on Let this script read your keychain on this Mac. Passwords stay in the Mac's Keychain.
KortShut refuses some scripts. Examples are scripts that wipe your files or a disk, and scripts that read your keychain without being asked.
To learn it by doing it, try the lesson: in the KortShut window, click Learn, then click Start lesson on Run a safe script by saying a phrase.
If it doesn't work
- Your words were typed, but nothing ran: the command is in Testing. Switch it to Live.
- Nothing ran, and the log says Close match: say the whole phrase, and nothing else.
- No words came out at all: see Dictation types nothing, or the wrong words.
Related
- Type with your voice
- Say a phrase, get a paragraph
- Make your own AI shortcut
- The permissions KortShut asks for, and why
Still stuck?
Email support@kortshut.ai. Tell us what you tried. What to put in your email.