Configuration
App Settings
Open settings from the menubar icon dropdown. The settings window has three tabs: General, Appearance, and About.
General
| Setting | Options | Default | Description |
|---|---|---|---|
| Frame Rate | 12, 24, 30, 60 | 30 | Frames per second for recordings |
| Loop Count | Infinite, Once, Three | Infinite | How many times the GIF loops on playback |
| Show Cursor | On/Off | On | Include the mouse cursor in recordings |
| Default Save Location | Any folder | -- | Where GIFs are saved by default (via folder picker) |
| Launch at Login | On/Off | Off | Start QuikGIF when you log in (via SMAppService) |
| Optimize File Size | On/Off | Off | Enable frame diffing to skip unchanged pixels between frames |
| Show Preview | On/Off | Off | Review the GIF before copying, saving, or sharing |
| Max Duration | 30s, 1m, 2m, 5m, 10m, Unlimited | Unlimited | Auto-stop recording after the specified duration |
| Output Format | GIF, WebP | GIF | Output file format |
| Max File Size | No Limit, 1 MB, 2 MB, 5 MB, 10 MB | No Limit | Automatically reduces quality to fit the size limit (GIF only) |
| Recording Shortcut | Any key combo | Cmd+Shift+6 | Global hotkey for starting/stopping recordings |
Appearance
Customize how the menubar icon and recording overlay look.
About
Shows version info, links to support and feedback, and a button to install or update the CLI tool.
CLI Flags
The CLI accepts flags on every command to override defaults. Common flags used across commands:
| Flag | Description | Default |
|---|---|---|
--fps | Frame rate | 30 |
--max-width | Maximum output width in pixels | 800 |
--full-resolution | Use native resolution (ignores --max-width) | Off |
--loop-count | GIF loop count (0 = infinite) | 0 |
--show-cursor / --no-show-cursor | Show cursor in recording | On |
--palette-strategy | Color palette: auto, global, per-frame | auto |
-o, --output | Output file path | recording.gif |
-q, --quiet | Suppress progress output | Off |
info
For the full flag reference for each command, see the CLI Reference.
Scripting Defaults
When using .qgif scripts, defaults are configured with the set command:
set fps 30
set max-width 800
set loop-count 0
set show-cursor true
set output output.gif
See the Scripting Reference for all configurable settings.