Guides

How to Convert Screen Recording to GIF on Mac

Learn how to turn screen recordings into GIFs on Mac. Covers free tools, quality settings, file size optimization, and the best methods for GitHub, Slack, and docs.

GIFs are the universal format for showing quick demos — in GitHub PRs, Slack messages, documentation, README files, tweets, and bug reports. A 10-second GIF can explain what a paragraph of text can't.

But turning a screen recording into a good GIF on Mac isn't obvious. The built-in tools don't support GIF export, and most online converters produce blurry, oversized files. Here's how to do it right.

Why GIFs Instead of Video?

  • Auto-play everywhere — GIFs play automatically in GitHub, Slack, Discord, Notion, and most web pages. No click needed
  • No player controls — cleaner look in documentation and README files
  • Universal support — every browser, email client, and chat app supports GIFs
  • Loops automatically — perfect for short demos and UI interactions

When NOT to use GIFs:

  • Videos longer than 15-20 seconds (file size explodes)
  • Content that needs audio
  • High-resolution full-screen recordings (use MP4 instead)

Method 1: Highlight Studio (Record + Edit + Export as GIF)

The fastest workflow is to record and export to GIF directly from one app. Highlight Studio does this natively.

Steps:

  1. Open Highlight Studio and record your screen (or open an existing recording)
  2. Edit on the timeline — trim to just the segment you want as a GIF
  3. Add zoom effects if needed (important for small UI elements)
  4. Click Export and select GIF as the format
  5. Choose your settings:
    • FPS — 10-15 fps for most GIFs (lower = smaller file)
    • Resolution — 720p or lower recommended for GIFs
    • Quality — adjust the color palette for file size vs quality trade-off
  6. Export — done

Why this is the best method:

  • You can edit before exporting — trim, add zoom, adjust timing
  • GIF export is built in — no separate conversion step
  • Custom FPS control — most converters don't offer this
  • Metal-accelerated rendering — fast export even for long GIFs

Method 2: FFmpeg (Free, Command Line)

If you already have a .mov or .mp4 file and want to convert it to GIF from the terminal, FFmpeg is the standard tool.

Install FFmpeg:

brew install ffmpeg

Basic conversion:

ffmpeg -i recording.mov -vf "fps=12,scale=800:-1" -loop 0 output.gif

Higher quality with color palette optimization:

# Generate optimized palette
ffmpeg -i recording.mov -vf "fps=12,scale=800:-1:flags=lanczos,palettegen" palette.png

# Use palette for better colors
ffmpeg -i recording.mov -i palette.png -lavfi "fps=12,scale=800:-1:flags=lanczos[x];[x][1:v]paletteuse" output.gif

Key parameters:

  • fps=12 — frames per second. Lower = smaller file. 10-15 is the sweet spot
  • scale=800:-1 — width in pixels, height auto-calculated. Keep under 800px for reasonable file sizes
  • -loop 0 — loop forever
  • palettegen/paletteuse — generates an optimized 256-color palette for much better quality

Pros:

  • Free and open source
  • Maximum control over output
  • Can be scripted and automated

Cons:

  • Command line only — not beginner-friendly
  • No editing — you need to trim the video first
  • Trial and error to find the right settings

Method 3: Gifski (Free Mac App)

Gifski is a free Mac app that converts video files to high-quality GIFs. It uses a perceptual color quantization algorithm (pngquant) for better quality than FFmpeg's default palette.

Steps:

  1. Download Gifski from the Mac App Store (free)
  2. Drag your .mov or .mp4 file into the app
  3. Set FPS, dimensions, and quality
  4. Click Convert

Pros:

  • Very high quality GIF output
  • Simple drag-and-drop interface
  • Free

Cons:

  • No editing — just conversion
  • Can produce large files at high quality settings
  • No screen recording built in

GIF Size Optimization Tips

GIF file sizes can get out of control fast. Here's how to keep them reasonable:

SettingRecommendationImpact on Size
Resolution600-800px wideHigh — halving width reduces size ~4x
FPS10-15 fpsHigh — 30fps is 2-3x larger than 10fps
DurationUnder 15 secondsLinear — longer = proportionally larger
Colors128-256 paletteMedium — fewer colors = smaller file
ContentMinimal motionHigh — lots of motion = much larger

Target file sizes:

  • GitHub PRs/Issues — under 10 MB (GitHub's limit)
  • Slack — under 5 MB for inline preview
  • Documentation — under 2-3 MB for fast page loads
  • README files — under 5 MB

GIF vs MP4 for Documentation

A common question: should you use GIF or MP4 in your docs?

GIFMP4
Auto-playYes, everywhereDepends on platform
File sizeLarge (no compression)Small (H.264 compression)
Quality256 colors maxFull color
AudioNoYes
GitHub supportInline previewInline preview (since 2021)
Browser supportUniversalUniversal

Rule of thumb: Use GIF for short demos under 10 seconds. Use MP4 for anything longer or when you need better quality at smaller file sizes.

Conclusion

For the best workflow on Mac, use Highlight Studio to record, edit, and export directly to GIF — no separate conversion step needed. For existing video files, FFmpeg gives you the most control, and Gifski offers the best quality with a simple interface.

gif · screen recording · mac · how to · developer tools · documentation