A full keyboard or a keystroke pill: which reads better in a video
For most screen recordings, a keystroke pill reads better than a full on-screen keyboard. It takes a corner instead of a band of the screen, it spells out exactly what you pressed, and a good one names the shortcut too, so viewers read “⇧⌘4 Screenshot Selection” in one glance. A full keyboard reads better when where the keys are is part of the lesson: single-key tools, a new layout, Vim, games, or viewers who are still looking for the Option key. When a video teaches both, show both.
What each one actually shows
A full on-screen keyboard draws the whole board and lights each key as you press it. What the viewer learns is position: that Option sits between Control and Command, that Z, X, C and V share a row under the left hand, that a shortcut takes one hand or two.
A keystroke pill shows text. Each key appears as a keycap, a shortcut appears as its symbols, and a name can follow. Typing collects into a running line. What the viewer learns is exactly what you pressed, in order, without having to turn lit keys back into letters.
The difference shows most in fast moments. Press Command-Shift-4 (⇧⌘4) and a board lights three keys at once, in three places, and the viewer has to read all three before they go dark. A pill writes ⇧⌘4 in one spot, and a name beside it says what it did.
When a pill reads better
- Shortcut-heavy tutorials. Editing, coding and design videos can have a shortcut every few seconds. A pill keeps a readable record of each one.
- Typing. Typed text in a pill reads as words. On a board, fast typing is a flicker of keys nobody can follow.
- Busy frames. A pill fits in a corner of a 1080p frame without covering much. A board big enough to read takes a whole strip of the screen.
- Vertical video. A narrow 9:16 frame has no room for a full-width board at a readable size. Showing keystrokes in vertical video covers that case.
- When the name matters more than the keys. Viewers often remember “Insert Link” more easily than ⌘K, and a name tells them which menu item to look for if they forget the keys.
Typebar’s pill names each shortcut with the name it has in the app you are using, read from that app’s own menus, so “⌘K Insert Link” matches the menu item your viewer will find. Typing gathers into one chip, a shortcut pressed again counts up as ×2, ×3 instead of repeating, and you can show everything or only shortcuts, with or without keys like Return and Tab. Clicks can show in the pill as well, as Click, Right Click or ⌘ Click.
When a full keyboard teaches more
- Single-key tools. In Figma, V is Move, R is Rectangle and T is Text. A pill shows “R”. A board shows R lighting up under the left hand, next to the keys for the other tools, which is how people learn a tool set.
- Keys that matter for where they sit. Vim moves with H, J, K and L, side by side on the home row under the right hand; many games use W, A, S and D under the left. A board makes the shape visible. Making a Vim or Neovim tutorial where viewers see each keystroke goes into this.
- Other layouts and keyboards. If you record on an ISO or JIS keyboard, or type in AZERTY or Dvorak, viewers on a different layout need to see where the key is, not only its name.
- Beginners. People new to the Mac often do not know where Option or Control is. Seeing the key light up answers the question before they ask it.
- Holding a modifier. When you hold Command and talk about what it does, a board can show the whole answer at once.
Typebar’s board comes in MacBook, Magic Keyboard with or without a number pad, and tenkeyless shapes, in ANSI, ISO and JIS, and its keys follow your input source, so QWERTZ, AZERTY, Dvorak and Colemak show as they are. Hold a modifier for a moment and the keys relabel with what they do in the app in front, which turns a pause in the narration into a cheat sheet the viewer can read.
The two side by side
| Keystroke pill | Full keyboard | |
|---|---|---|
| Space on screen | A corner | A band across the frame, or a large corner |
| What it shows | What you pressed, in order, as text | Where each key is |
| Shortcut names | Yes, when the tool names them | Not as a rule |
| Typing | Reads as words | A flicker of keys |
| Best for | Shortcut-heavy tutorials, fast typing, vertical video | Single-key tools, layouts, Vim, games, beginners |
| Weak at | Showing where a key is | Fast sequences, narrow frames |
Show both when the video teaches both
Some videos need both at once. A Figma course mixes single-key tools with modifier shortcuts. A Vim tutorial has motions, where position matters, and commands, where the text matters. A beginners’ course teaches where the keys are and what the shortcuts are called.
The layout that usually works: the board along the bottom or top of the frame, a little smaller than you would make it on its own, and the pill just above or beside it, so the viewer’s eye finds both in one place. Keep both on the same side of the frame. A board at the bottom and a pill at the top make the viewer look in two places for one shortcut.
In Typebar, the menu bar menu’s Show submenu switches between Keyboard Only, Pill Only, and Keyboard and Pill, and each mode keeps its own size and place on screen. You can set the board and pill up together for one video and go back to the pill alone for the next, without rearranging either.
Making either one readable
Whichever you choose, the same few things decide whether viewers can read it:
- Size. Size it for the smallest screen your viewers use, not the one you record on. How big should on-screen keys be in a 1080p or 4K recording works through the numbers.
- Contrast. A dark board on a dark app disappears into it. Pick a look that stands apart from the app you record. Typebar’s pill comes in light, dark or glass, and there are 40 themes. Typebar also follows the macOS Increase contrast setting (System Settings > Accessibility > Display), which makes every legend easy to read.
- Motion. If press animations look busy in the export, turn on Reduce motion in System Settings > Accessibility > Display. It is a macOS setting, not a Typebar one, and Typebar follows it by turning presses into instant color changes.
- Place. Wherever the app leaves space, usually a lower corner, never on top of the work. Where to put a keystroke overlay has a table by app.
Typebar is $9 once for up to 5 Macs, free for 24 hours with everything on.
Questions
Which is better for a coding screencast?
Usually the pill, because coding is fast typing mixed with shortcuts, and the pill turns both into readable text. Add the board when the lesson is about Vim motions or a particular keyboard layout.
Can viewers read a full keyboard on a phone?
Only if it takes up most of the width of the frame. At the size that fits in a corner, the legends are too fine to read on a phone, which is why the pill suits phone viewers better.
Is one of them less distracting?
The pill, in most videos. It changes only when you press something, in one spot. A full board lights keys all over the frame, which is useful when position is the point and noise when it is not.