QuikGIF Tutorials - How to Record GIFs on Mac

How to Record a GIF on Mac in 3 Steps

1

Click the QuikGIF icon in your menubar, or press your configured global hotkey to instantly activate the region selector.

2

Drag to select any area of your screen. You can resize by dragging the edges or corners, or reposition by dragging the interior. When you are satisfied with the region, press Start or hit Return.

3

Click Stop when you are done recording. Your GIF is ready immediately -- save it to disk, copy it to your clipboard, or share it directly to any app via the share menu.

More capabilities

Pause and resume recording at any time to skip irrelevant sections
Choose your frame rate: 12, 24, 30, or 60 FPS to match your content
No time limits and no watermarks on any recording
Configure loop behavior: infinite, once, or three times

How to Automate GIF Creation with Scripts

QuikGIF includes a CLI tool with a built-in scripting engine for fully automated GIF creation. Write a .qgif script to open apps, type commands, record, and render -- all hands-free.

Install the CLI

$ brew install ringo380/tap/quikgif

Create a script

Save the following as demo.qgif. This script opens Terminal, types a command, records the output, and renders the result as a GIF.

        # demo.qgif -- Record a terminal session
        set fps 24
        set max-width 800
        set output demo.gif
        
        open Terminal
        wait 1
        record $terminal duration 5 continue
        type "echo Hello from QuikGIF"
        wait 0.5
        key return
        remain
        render
      

Run it

$ quikgif script demo.qgif

See the full scripting reference for all 22 commands, settings, and variables.

Best Practices for GIF Bug Reports

A short GIF is often worth more than a paragraph of text when reporting a bug. GIFs autoplay inline -- no video player needed, no extra clicks for reviewers.

Keep it focused: record only the relevant screen area, not your entire display
Use pause to skip setup steps so the viewer sees only the actual bug
Copy to clipboard and paste directly into GitHub issues, Jira tickets, or Slack messages
GIFs are supported everywhere -- they render inline without any embedding or hosting
Use 12 FPS for UI bugs where file size matters; use 30 FPS for animation glitches that need clarity

Recording Tips and Tricks

Choose the right frame rate

12 FPS -- Best for simple UI walkthroughs and documentation. Small file sizes.
24-30 FPS -- Smooth motion for general screen recordings and demos.
60 FPS -- Full detail for fast animations, scrolling, or game-like content.

Use keyboard shortcuts

Set a global hotkey in QuikGIF settings to start recording without touching your mouse. This keeps your hands on the keyboard and your workflow uninterrupted. The default hotkey can be customized to any key combination.

Set a default save location

Open Settings and choose a default save directory. Every time you save a GIF, it goes straight to your preferred folder -- no file picker dialog, no extra clicks. Ideal for teams that save recordings to a shared folder.

Cursor visibility

Toggle cursor visibility in Settings. Show the cursor for UI tutorials where pointer context matters, or hide it for clean output when the cursor would be distracting.

Tutorials & Guides