How big should on-screen keys be in a 1080p or 4K recording
Size on-screen keys as a share of the frame, not in pixels. A keycap that takes up a twentieth of the frame’s height takes up a twentieth of it at 1080p and at 4K, and on a phone it ends up the same size either way; the higher resolution only makes it sharper. Make the keys clearly bigger than the text in the app you are recording, then settle the size by watching a short test export on your phone at arm’s length.
The rest of this post is the reasoning behind that, a starting size for each way of showing keys, and the test.
What your Mac records, and what export does to it
On a Retina display, a recording of the whole screen comes out at about twice the size macOS uses to lay things out, in each direction. A 14-inch MacBook Pro at its default setting lays out its screen as 1512 by 982 points and records it as a 3024 by 1964 pixel movie. To see what yours records, open a recording in QuickTime Player and choose Window > Show Movie Inspector (Command-I), which lists the movie’s size.
Then export changes it:
- 4K (3840 by 2160). A 3024 by 1964 recording fits almost as it is, so every key, menu and line of text keeps roughly the size in pixels it had on your screen.
- 1080p (1920 by 1080). The frame has to shrink to a bit over half its height to fit, and everything in it shrinks with it.
A MacBook screen is also taller than 16:9, so a whole-screen recording either gets bars at the sides or loses some of its top and bottom when it goes into a widescreen frame. Either way, the keys stay the same share of what is left.
Why the viewer’s screen matters more than resolution
A phone shows a 4K video and a 1080p video at the same physical size. If your keys are hard to read in the 1080p version on a phone, the 4K version will be just as hard to read, only sharper. What resolution does change is how well thin legends survive: they hold up at 4K, and they are the first thing to smear when a player drops to a lower quality on a slow connection, which YouTube and most players do on their own.
So the real question is where people watch:
- A phone held sideways. The video fills the screen, but the screen is about a hand wide.
- A phone held upright. A widescreen video plays in a strip across the screen, much smaller again.
- A laptop, often in a browser window that is not full screen.
- A TV or large monitor, where size is rarely the problem.
Size for the phone held sideways. Viewers holding it upright will tap full screen when they need to read something, as long as there is something readable to tap for.
A starting size for each mode
My own rule of thumb, from my recordings rather than any standard: make the keys two to three times the height of the body text in the app, as it appears in the recording. Viewers read your keys at a glance while they watch the app, so the keys have to win.
A keystroke pill. It shows only what you press, so it can be large without covering much. If the pill also names each shortcut, the name has to be readable too, not only the keycaps. A pill one line high, sized that way, usually reads well on a phone.
A full keyboard. A Mac keyboard is about fourteen keys across, and that is the problem. Make the board a third of the width of a 1080p frame and each key is roughly 45 pixels wide, with the letter on it a fraction of that. Use the full keyboard when where the keys are is the lesson, and make it bigger than feels comfortable while you record.
Both together. The board shows where your fingers went and the pill says what happened. Let the pill carry the size, since it is what viewers actually read.
In Typebar, each mode (Keyboard, Pill, and both) keeps its own size and place on screen, so a large pill for recording does not change the board you use while learning shortcuts. Profiles keep sizes and places too, and Typebar comes with a ready-made Recording profile you can change. One setup for recording, another for teaching covers switching between them.
Make the whole picture bigger, not only the keys
Readable keys over an unreadable app help no one. Three ways to make everything larger in the frame:
- Record part of the screen. Press Command-Shift-5 (⇧⌘5), choose Record Selected Portion, and drag the box around the window you are using. The box becomes the whole frame, so everything in it takes up more of it. Keep the keys inside the box.
- Pick a larger display setting while you record. In System Settings > Displays, choose an option toward Larger Text. Windows, menus and text all get bigger on screen.
- Zoom the app. Command-Plus zooms in many apps, including Safari, and Terminal’s View > Bigger does the same for its text.
Recording a part of the screen also means export shrinks it less. On a Retina display, a 1280 by 720 point area records at 2560 by 1440 pixels, and a 1080p export keeps three quarters of its size, against just over half for the whole screen of that MacBook Pro.
Size is not the only thing that makes keys readable
- Contrast. Put a dark pill over a light app and a light pill over a dark one. Glass looks good, but a busy window behind it lowers the contrast. Typebar follows the macOS Increase Contrast setting (System Settings > Accessibility > Display), which makes every legend easier to read.
- Weight. Video compression is hard on thin lines and subtle colors. A theme with bold legends and strong colors survives a low-quality stream better than a delicate one.
- Placement. Big keys in the wrong place cover the thing viewers are trying to see. Where to put a keystroke overlay goes through the usual spots.
- Time. Viewers need a moment to read a shortcut. Leave a beat after each one before the next, and the size you chose has time to work.
Test it on a phone before the real take
This takes a few minutes and saves re-recording a whole video.
- Record about twenty seconds using the shortcuts your video uses, with the keys at the size you plan to use.
- Export at the resolution you will publish, for example with File > Export As > 1080p in QuickTime Player, or your editor’s usual export.
- AirDrop it to your phone and play it held sideways at arm’s length, then upright.
- Ask one question: can you read each keycap and shortcut name at a glance, without pausing? If you squint, make the keys bigger. If they cover something you need, move them or record a smaller area.
- When it reads well, save the setup in a profile so the next video starts from there.
If the video is for Shorts, Reels or TikTok, the frame is narrow and the rules change; showing keystrokes in vertical video covers that case.
Questions
Is it worth exporting at 4K just for sharper keys?
If the recording came from a Retina screen, you have the pixels for it, and 4K keeps thin legends crisp. It does not make them any bigger on a phone, though. Get the size right first, then pick the resolution.
Should keys be bigger for a pill or for a full keyboard?
Both should be readable, but a full keyboard needs much more room to get there, because each key is a fourteenth of its width. For most tutorials, a large pill does the job with less of the frame. A full keyboard or a keystroke pill compares the two.
Does the display resolution I record at change anything?
Mostly through how big everything looks. A Larger Text setting makes the app and its text take up more of the frame, which helps phone viewers more than any export setting.
Typebar is $9 once for up to 5 Macs, and free for 24 hours with everything on.