Guides

Dictate on a Mac with one key, a switch, or a pedal

You can dictate on a Mac with one key: in YapToText, one tap starts a dictation, the next tap stops it, and your words are typed at the cursor in any app. Any single key can be the trigger, so a switch or a foot pedal that presses one key can run it too. My hands don't work, so the question I care about is not which shortcut is convenient, but how much a hand has to do to start and stop.

This page ranks the options from the least effort to the most and says exactly what each needs. Nothing has to be held down unless you want it that way, nothing needs two keys at once, and there is no wake word. YapToText is free and runs on an Apple silicon Mac with macOS 14 or later.

Download YapToText on the Mac App StoreDownload for free. No account, nothing locked, macOS 14 or later on Apple silicon. Source on GitHub.

On this page: 11 sections
  1. Steps
  2. Ranked by how much your hands have to do
  3. One key, tapped
    1. Set the key
  4. Hold to talk, if holding is easier than tapping twice
  5. Stop without pressing the key again
  6. Switches and pedals that show up as a key
  7. No hands at all: the button in the menu bar
  8. Forgive stray presses and shaking hands
  9. If the key does nothing
  10. The short version
  11. Questions

Steps

  1. Open YapToText and go to the Dictation page.
  2. In the Keys card, click the key field and, when it reads Tap a key, press the key you want, or the switch or pedal that sends one.
  3. Choose Tap to start / stop, or Hold to talk if holding is easier for you.
  4. Click into a note, press your key, say a sentence, and press it again.
  5. If one press is all you can count on, turn on Auto-stop after silence in the Recording card.

Ranked by how much your hands have to do

This is the ladder the rest of the page follows, from the least your hands do to the most:

  1. Nothing. Voice Control clicks the Start Dictation button in the menu bar panel for you.
  2. One press. Tap once to start, and let Auto-stop after silence end the dictation when you stop talking.
  3. One key, tapped twice. Tap to start and tap again to stop. This is the default.
  4. One hold. The same key, held down for as long as you talk.
  5. One motion somewhere else. A switch or a foot pedal that sends a key press, which the app treats as that key.

Every rung is already in the app, and every one is free. The dictation key and its tap or hold choice live on the Dictation page, in the Keys card, and the Quick Edit key has the same choice on its own page.

One key, tapped

The default trigger is Right Command. Tap it once to start, talk, and tap it again to stop, and your words are typed at the cursor in whatever app you were in. Tap, talk, tap: one key does the whole job. There is no chord and no second key, and Command with another key, as in Command C, never starts a dictation, because a tap only counts when nothing else was pressed.

It does not have to be Right Command. Right Control, Left Control, Fn (Globe), Right Option, Left Option, Right Shift and Caps Lock all work, and so does any other single key, such as a letter, an F-key or a number pad key, which then stops typing and becomes the trigger. With Caps Lock as the trigger, the app turns the lock and its light back off. Pick a key you never type with.

Set the key

  • You: On the Dictation page, in the Keys card, click the key field. When it reads Tap a key, press the key you want, then choose Tap to start / stop beside it.
  • YapToText: Records that key as the trigger, and flags it in red if the Quick Edit key already uses it.
  • Check: Click into a note and tap the new key. The floating panel appears and the menu bar capybara's speech bubble turns red.

If one press is all you can count on, turn on Auto-stop after silence in the Recording card. The dictation then ends after 0.5 to 5 seconds of quiet, as if you had tapped again. It is off by default, because a long pause to think ends the dictation too.

YapToText's Dictation settings page on a Mac: the Keys, Recording, Microphone and Delivery cards.
Figure 1. The Keys card holds the dictation key and its tap or hold choice, and the Recording card below it holds Auto-stop after silence, off by default.

While a dictation runs, three more keys are live: Space pauses and resumes, Esc cancels, and 1 to 9 pick the mode. They are captured only while you dictate, so the rest of the time they type as usual. The keys and shortcuts page has the full list.

Hold to talk, if holding is easier than tapping twice

Some hands can hold a key down more easily than they can land on it twice. For them, the same key has Hold to talk, chosen in the same Keys card. Recording runs while the key is down and stops the moment you let go, so a short thought is press, speak, release. Releasing the key always ends the dictation, even if you let go while it is still starting.

The Quick Edit key, Right Option by default, has the same tap or hold choice on its own page. It taps by default too: I moved it from holding to tapping because tapping matches the dictation key and is easier on hands that cannot hold a key down. Select text, tap the key, say the change, tap again, and the rewrite replaces the selection. Tap or hold is a setting, so it can change as your hands do.

Stop without pressing the key again

If the first press is the only one you can count on, a dictation can end without the key:

  • Silence. Auto-stop after silence ends it after 0.5 to 5 seconds of quiet.
  • The floating panel. It has pause, stop and insert, and cancel buttons, and the same three are accessibility actions.
  • The menu bar panel. Click the capybara while recording, and its header shows Cancel, Pause and Stop and insert.
  • A time limit. Maximum length, in the Recording card and off by default, stops a dictation after up to 300 seconds, set in 15-second steps.
The compact layout of YapToText's floating panel: one row with the waveform and the cancel, pause and stop buttons.
Figure 2. Cancel, pause and stop on the panel, here in the Compact layout, so a dictation can end without a second key press.

Starting takes one press, and stopping can take none. The buttons are what a pointer or Voice Control can reach. The menu bar page and the floating panel page show each one, and the accessibility hub has the rest of the VoiceOver and Voice Control story.

Switches and pedals that show up as a key

Because the trigger is a key, anything that presses one key can be the trigger: a USB foot pedal, an adaptive switch plugged into a switch interface, or a button mounted on a wheelchair and wired to that interface. If the Mac sees it as a key, it can start and stop a dictation. Set the pedal or the interface to send one key, record that key as the dictation key, and pick tap or hold. I have not tested every switch interface, so this describes how the trigger works, not a guarantee for your setup.

The test takes ten seconds:

  • You: On the Dictation page, click the key field, and when it reads Tap a key, press the pedal or the switch.
  • YapToText: Takes whatever key the device sends and makes it the dictation key.
  • Check: The field now shows the device's key. If it goes back to the old key after ten seconds without changing, the device did not send a key, and that is a setting on the device or its interface, not in YapToText.

A game controller, a mouse side button or a MIDI pad sends no key of its own. InputConfig, my other free Mac app, sends a key press from any of them, so that button can be the dictation key, and its guide to starting dictation from any button walks through the setup. I have not tested every controller with it, so the ten-second test above still applies.

If you drive a power wheelchair and the joystick is your mouse, the split is simple: the chair does the pointing, a switch does the one key, and YapToText does the words. I make joystick toppers for power wheelchairs, so what one hand on a joystick can and cannot reach is something I think about a lot.

macOS also has Switch Control, which lets an adaptive switch or joystick enter text and control the whole Mac. It is a different path from a switch that simply presses one key, and Apple's guide covers setting it up.

No hands at all: the button in the menu bar

Click the capybara in the menu bar and a small panel opens. The button at the top reads Start Dictation and does the same job as the dictation key; while you record, the panel's header shows Cancel, Pause and Stop and insert instead. That gives Voice Control something to aim at, since it clicks controls by name, and Voice Control is a free part of macOS. The hands free typing guide has the full Voice Control setup, including how to keep it from typing your sentences too.

YapToText's menu bar panel: Start Dictation, mode and microphone pickers, Transcribe file, Regenerate and Insert last.
Figure 3. Click the capybara and Start Dictation sits at the top of the panel. It does the same job as the dictation key, and it gives Voice Control a name to aim at.

YapToText itself has no wake word, on purpose. The microphone lets go about a second after each dictation, unless you turn on Keep the microphone warm, and the recording indicator shows only while you dictate. A wake word means a microphone that is always open, waiting for its name and hearing everything else in the room while it waits. Nothing starts until you press the key, the switch or the pedal, or Voice Control clicks the button. If you start by voice, the listening belongs to Voice Control and its settings, not to this app. Nothing you say leaves the Mac either way, and the privacy page has the rest.

Forgive stray presses and shaking hands

A hand that shakes or lands on the wrong key needs a trigger that forgives it. Space and the number keys are ignored outside a dictation, so a stray press never starts, pauses or changes anything. A stray press of the dictation key while the app is still finishing a dictation is ignored too, so a double tap cannot throw away the result.

A stray Esc was once the expensive one. Since 1.5.1 a canceled dictation is still transcribed and saved to History, marked as canceled and never inserted, so the words can be copied back out; Keep canceled dictations is on by default in Settings, Advanced, History & audio. For more margin, turn on Require pressing Escape twice to cancel in the Keys card, and a cancel needs a second press within 0.6 seconds.

If a dictation went in wrong, you do not retype it: Quick Edit fixes it by voice, and the menu bar's Regenerate redoes your last dictation as any mode. If the full floating panel pulls your eye, the Mini layout keeps only the waveform on screen, and the panel can be turned off entirely; dictation works the same either way. A shaky press costs you nothing you said.

The mini YapToText panel: a small dark rounded panel showing only a blue waveform, with no buttons or text.
Figure 4. The Mini layout keeps only the wave on screen, for when the full panel pulls your eye.

If the key does nothing

Climb this ladder, smallest step first:

  1. Check that the app is running. The key works only while YapToText is open. If the capybara is not in the menu bar, open the app, and turn on Launch YapToText at login in Settings, General.
  2. Turn on Accessibility. The dictation key needs it. The Get set up card on the Home page stays until it is on.
  3. Look for red. A key the Quick Edit key already uses is flagged in red; pick another for one of them.
  4. Try the other side. Left Command and Left Shift cannot be the trigger, and the key field says so. The right-side keys, Fn and Caps Lock all work.
  5. Use the backup shortcut. Control Option Space, in Settings, General, Shortcuts, starts and stops a dictation even without Accessibility. It is three keys, so it is a stopgap, not a home.

The troubleshooting guide covers the rest, starting with what to do when the words land on the clipboard.

The short version

  • One key is enough. Tap to start, tap to stop, and any single key can be the one.
  • Stopping can take no press. Auto-stop after silence or the panel's buttons end a dictation.
  • A switch or pedal can be the key. If it sends a key press, the key field on the Dictation page shows it in ten seconds.

Settings by condition are in dictation for tremor, Parkinson's, MS and ALS. If you are setting this up for someone else, the guide for an older parent keeps it simple.

Nothing has to be held, nothing needs two keys, and nothing listens until you start it. If your setup does something this page does not describe, open an issue on GitHub. Every one gets read.

Download YapToText on the Mac App StoreDownload for free. No account, nothing locked, macOS 14 or later on Apple silicon. Source on GitHub.

About the author. Ryleigh Newman is a developer whose hands make typing difficult and who dictates every day with YapToText, the app this site describes. Facts about other apps come from their own sites, with the date they were read. More about the project.

Sources

Questions

Can I dictate on a Mac without holding a key down?

Yes. Tap to start / stop is the default in YapToText: one tap starts, the next tap stops, and the words are typed at the cursor. Hold to talk is the other choice, on the Dictation page, and it records only while the key is down.

Can an adaptive switch or a foot pedal start dictation?

If it sends a key press, yes. Any single key can be the dictation key, so set the switch interface or pedal to send one key and record that key on the Dictation page. I have not tested every switch interface, so test yours: if the key field shows its key when you press it, it can be the trigger.

Is there a wake word?

No. The microphone lets go about a second after each dictation, so nothing is listening until you press the key, the switch or the pedal. For a start by voice, Voice Control can click the Start Dictation button in the menu bar panel.

What if my hand hits Escape by accident?

The words are not lost. A canceled dictation is still transcribed and saved to History, marked as canceled, and never typed, unless you turn off Keep canceled dictations. You can also require two presses of Escape to cancel.

Can I stop a dictation without pressing the key again?

Yes. Turn on Auto-stop after silence and a dictation ends after 0.5 to 5 seconds of quiet. The floating panel and the menu bar panel also have stop, pause and cancel buttons that a pointer or Voice Control can reach.

Which key should I make the trigger?

One you never type with and can reach every time. Right Command is the default, and a letter, an F-key or a number pad key also works, which then stops typing while it is the trigger. Space, Esc and the number keys are captured only during a dictation.