Screenshots and recording

How to turn a Mac screen recording into a GIF

Updated · 3 min read

macOS cannot save a screen recording as a GIF. Here is how to do it free with ffmpeg in Terminal, what makes GIFs large, and how Orrel makes a GIF from a recording or any video in a couple of clicks.

A GIF is still the easiest way to show a short interaction in a README, a bug report or a chat that does not autoplay video. macOS records the screen as a MOV file and offers no GIF export, so you need one more step.

Record the right thing first

Most of a good GIF happens before conversion. Press ⇧⌘5 and choose Record Selected Portion, then drag an area just around the part you want to show. A small area and a short recording, a few seconds, make a GIF that loads quickly and reads clearly.

To cut the start and end, open the recording in QuickTime Player, choose Edit › Trim (⌘T), drag the yellow handles and click Trim, then save.

Convert with ffmpeg

ffmpeg is a free command-line video tool. Install it with Homebrew (brew install ffmpeg), then run:

ffmpeg -i recording.mov \
  -vf "fps=12,scale=960:-1:flags=lanczos,split[a][b];[a]palettegen[p];[b][p]paletteuse" \
  recording.gif

What the parts do:

Add -ss 2 -t 6 before -i to start two seconds in and keep six seconds.

Keeping GIFs small

How Orrel does it

When you stop a recording made with ⌥⇧⌘5, Orrel offers to trim it, then Make GIF. The GIF is written beside the MP4, so you keep both, and you can copy either straight into a message or drag it into an issue.

For a video you already have, Control-click it in Orrel, drop it on Orrel's Dock icon, or use Finder's Quick Actions, and choose GIF from the ring of conversions. The same ring compresses, trims and converts MOV and MP4, or extracts the audio.

If you use an AI assistant connected to Orrel, "turn the screen recording on my Desktop into a GIF" does the same thing on your Mac.

Where Orrel stops

A GIF made from a recording covers up to 30 seconds, which is about the most a GIF should be. Orrel does not offer frame-by-frame editing, captions, or fine control over palette and dithering; if you need those, ffmpeg or a dedicated GIF tool gives you every setting. GIF cannot carry sound, so if the audio matters, send the MP4.

Questions

Why is my GIF so large?

GIF stores every frame as a separate picture with up to 256 colours and compresses poorly compared with video. Length, frame rate and pixel size all multiply the file size. A short clip of a small area is the way to keep it reasonable.

Should I use a GIF or an MP4?

Where MP4 is accepted, use it: it is smaller and sharper, and has sound. GIFs earn their place where video does not autoplay or is not allowed, such as README files, some issue trackers and email.

Is there a length limit on Orrel's GIFs?

GIFs made from a screen recording cover up to 30 seconds. Trim the recording first so the GIF shows only the part that matters.