Apps.Deals Logo
How to Make a Screen Recording GIF on Mac (With Keystrokes)

How to Make a Screen Recording GIF on Mac (With Keystrokes)

By Ram Patra•
use-case
keyscreen
gif
screen recordings
keyboard shortcuts
developers
mac

A short GIF is often the fastest way to show how something works: a feature in your app's README, a step in a help article, a fix you're explaining to a teammate in Slack. It plays on its own, loops and needs no click. It also has no sound, so if the trick involves a keyboard shortcut, the viewer sees a window change and has no idea why.

This guide covers the whole job on a Mac: recording the clip, putting your shortcuts on screen, converting it to a GIF and keeping the file small enough to upload.

Quick Takeaway

  • macOS can record your screen (Shift-Command-5) but can't save a GIF. Record a video first, then convert it with a free app like Gifski, or use an app that records GIFs directly, such as CleanShot X or Gifox.
  • A GIF is silent, so any keyboard shortcut in it has to be visible. A keystroke overlay such as KeyScreen shows the keys you press on screen while you record.
  • Keep it short and small: one action, a few seconds, a tight recording area and a modest frame rate. GitHub, for example, accepts images and GIFs up to 10 MB.

Why Screen Recording GIFs Are Harder Than They Look

A GIF looks like a tiny video, but it behaves differently:

  • No narration. In a normal tutorial you can say "now press Command-Shift-P". In a GIF, nothing tells the viewer which keys you pressed. Pointer movement is visible; shortcuts are invisible.
  • It loops. The viewer often catches it halfway through. The action has to make sense on the second or third watch, which rules out long, wandering clips.
  • It gets scaled down. A GIF in a README or a help article is usually shown narrower than your screen, so small text and small overlays become unreadable.
  • Files get big fast. GIF is an old format with a limited palette per frame. A full-screen Retina recording at a high frame rate can easily run to tens of megabytes, well past most upload limits.

None of this needs expensive software. It needs a bit of planning before you hit record.

The Basic Workflow

1. Decide the one thing the GIF shows. "Open the command palette and run Format Document" is a good GIF. "A tour of the settings window" is a video.

2. Prepare the screen. Close unrelated windows, hide desktop clutter, and make the app's text bigger than usual (Command-Plus works in many apps). Use sample data rather than real customer names or email addresses.

3. Record only the area that matters. Press Shift-Command-5, choose Record Selected Portion and drag the frame around just the window or panel you need. Apple's guide to recording the screen on Mac covers the options, including Show Mouse Clicks, which draws a circle around the pointer when you click. The recording is saved as a .mov file.

4. Show the keys you press. Turn on a keystroke overlay and place it inside the recorded area. Hold each shortcut a moment longer than you normally would so it stays on screen long enough to read.

5. Convert to GIF. Open the .mov in Gifski (free), trim the dead time at the start and end, set the width, and export. Gifski also lets you control looping, speed and quality, and can make a smaller, lower-quality GIF when size matters more than polish.

6. Check the size and the loop. Watch the GIF a few times at the size it will actually be shown. If it's too big, reduce the width or frame rate, or trim it further.

Size rules of thumb

These are starting points, not fixed rules:

SettingGood starting pointWhy
Length3 to 10 secondsOne action, easy to follow on a loop
Recording areaOne window or panel, not the full screenFewer pixels, bigger text when scaled
WidthAbout 800 to 1,000 pxFits a README or help article without being shrunk much
Frame rate10 to 15 fps for interface demosMenus and windows don't need 60 fps; motion design might
Upload limitCheck the destinationGitHub: 10 MB for images and GIFs

If a GIF still won't fit, consider a short MP4 instead. GitHub's file attachment rules accept .mp4, .mov and .webm videos (10 MB on free plans, 100 MB on paid plans) and recommend H.264 for compatibility. A video doesn't autoplay and loop like a GIF, but it's far smaller for longer demos.

Apps for Making GIFs on Mac

GifskiCleanShot XGifox 2Screen StudioCompresto
RoleVideo to GIF converterScreenshot and recording appGIF recorder and editorPolished recording and editingFile compression
Records the screenNo (use Shift-Command-5)Yes, as video or GIFYesYesNo
Converts video to GIFYesRecords GIF directlyYesExports GIFYes
Shows keystrokesNoYesNoYesNo
PriceFree$35 one-time with a year of updates, or Pro $10 per user per month billed yearlyFree Basic (10-second recording, watermark); Pro $14.99 one-time$9 per month billed yearly, or $29 monthlyFrom $49 one-time

Gifski (free, Mac App Store) is the simplest route: record with macOS, drop the video on Gifski, export. Its developer is clear that it is a converter, not an editor, so it won't add text or arrows. It does handle trimming, cropping, dimensions, speed, looping and frame rates up to 50 fps. The current version needs macOS Tahoe 26 or later.

CleanShot X records a selected area straight to GIF, and its recording settings can show clicks and keystrokes (all keys or only command keys). If you already use it for screenshots, it covers this whole job in one app. It's also on Setapp.

Gifox is built only for GIFs: record, import videos, trim, crop and fine-tune compression. The free Basic version limits recordings to 10 seconds and adds a small watermark; Pro removes both for a one-time $14.99. It's on the Mac App Store and Setapp too, and its developers say Gifox 3 is coming.

Screen Studio is for polished product demos with automatic zooms. It exports small looping GIFs up to 1080p and can show the shortcuts you press. It's a subscription, so it makes sense if you also make longer demo videos.

Compresto compresses videos, images and GIFs, and converts video to GIF. It's useful when you already have a GIF that's over an upload limit, or a folder of them to shrink.

A Practical Mac Workflow With KeyScreen

KeyScreen is a Mac app that shows the keys you press, and optionally your mouse clicks, as an overlay on screen. Because it's just an overlay, it works with any recorder: the built-in Shift-Command-5 recorder, Gifox, QuickTime or anything else.

1. Install and pick what to show. Get KeyScreen from the Mac App Store or the website. For most GIFs, show only shortcuts, not every letter: KeyScreen lets you choose any combination of modifiers (⌘, ⌥, ⌃, ⇧), function keys and special keys like Return, Esc, Tab and Delete. That way "⌘ ⇧ P" appears, but the text you type into a search box doesn't repeat underneath it.

2. Make the overlay big. The GIF will probably be shown smaller than your screen, so raise the font size above what looks right live. Pick a high-contrast theme, or create one in your brand colors, so it stays readable over both light and dark windows.

3. Put it inside the recorded area. Choose a preset position or drag the overlay anywhere, on any display. Place it near the bottom of the window you're recording, away from the menus and buttons you'll click.

4. Turn on clicks if they matter. KeyScreen can show left and right clicks. Use this, or macOS's Show Mouse Clicks option, not both, so viewers don't see two click effects.

5. Record, convert, check. Record with Shift-Command-5 (or your GIF app), convert with Gifski, then watch the loop at its final size. If you can't read the keys, increase the overlay size and record again; it's quicker than fixing it afterwards.

KeyScreen runs entirely on your Mac, and it doesn't receive keystrokes typed into password fields, so passwords never appear on screen. It costs $5.99 on the Mac App Store, is a one-time purchase, and needs macOS 15 Sequoia or later.

When You Don't Need KeyScreen

  • The GIF has no shortcuts. If you're only clicking through menus, macOS's Show Mouse Clicks option is enough.
  • Your recorder already shows keys. CleanShot X and Screen Studio both have keystroke display built in. If you record everything with one of them, try that first. KeyScreen is most useful with the free route (Shift-Command-5 and Gifski), with GIF tools that don't show keys like Gifox, or when you want the same overlay style across recordings, live demos and streams.
  • The GIF is a design showcase. For a smooth animation of your interface, an overlay can be a distraction. Explain the shortcut in the caption instead.

Example 1: A README GIF for a Menu Bar App

An indie developer wants the top of their GitHub README to show the app's main shortcut opening a quick-add panel.

  1. Set KeyScreen to show only modifiers and special keys, at a large size, positioned just below the panel's area.
  2. Press Shift-Command-5, select a roughly 900 × 500 point area around the menu bar icon and the panel, and record: press the shortcut, type a short entry, press Return, pause one second.
  3. Open the recording in Gifski, trim to about 6 seconds, set the width to 900 px and export.
  4. Check the size: it needs to be under GitHub's 10 MB limit. If it isn't, lower the width or quality, or upload an MP4 instead.

Viewers see "⌘ ⇧ Space", the panel opening and the entry being saved, on a loop, without reading a word.

Example 2: A Quick How-To in Slack

A teammate asks how to see hidden files in Finder. Instead of typing an explanation, you record a 4-second GIF: open a folder, press Command-Shift-Period, and the hidden files appear.

With KeyScreen showing "⌘ ⇧ ." in the corner, the GIF answers the question on its own, and the next person who searches the channel gets the same answer. CleanShot X users can do the same thing with its keystroke option and send the GIF without a separate converter.

Final Verdict

To make a screen recording GIF on a Mac, record a small area with Shift-Command-5 and convert it with Gifski, which costs nothing. Choose CleanShot X if you want recording, GIF export and keystrokes in one app you'll also use for screenshots, Gifox if you make GIFs often and want fine compression control, and Screen Studio if GIFs are a side product of polished demo videos.

Whatever you record with, remember that a GIF has no sound. If a shortcut matters, show it: KeyScreen adds a clear, configurable keystroke overlay to any recorder, and it's the simplest way to make a silent GIF explain itself.

Catch these apps on sale: many paid Mac apps, including screen recording and GIF apps, run discounts at least once a year, most often around Black Friday. Subscribe to the Apps.Deals newsletter to hear when the deals arrive.

Note: Features and prices are current as of November 2026 and can change; verify them on each official site before buying.

Disclosure: KeyScreen is made by Softal, the same company behind Apps.Deals. This post also contains affiliate links; if you buy through them, we may earn a commission at no extra cost to you.

KeyScreen app icon

KeyScreen: Show your keystrokes on screen.

Display key presses with custom themes, layouts, multi-display support, and global shortcuts. Made for tutorials, streams, and live demos.