quikgif shot
Capture a single still image of a simulator, window, app, or screen region. [Pro]
quikgif shot [options]
Target Selection
Specify exactly one target.
| Flag | Type | Description |
|---|---|---|
--simulator | String | Capture the iOS Simulator's device framebuffer at native resolution. Takes a UDID or device name |
--simulator-auto | Bool | Shorthand for --simulator with no device argument (the only booted simulator) |
--window | UInt32 | Window ID to capture (use list-windows to find IDs) |
--app | String | Capture the first window of this app |
--region | String | Screen region: x,y,w,h or x1,y1:x2,y2 in points |
Simulator Capture
--simulator / --simulator-auto writes the device's native framebuffer pixels - the
same dimensions simctl reports for the device (e.g. 1320×2868 for an iPhone 16 Pro Max) -
not the scaled-down size the Simulator window composites at on screen (roughly 494×1054 at
typical zoom). This is the only route to a pixel-exact, App Store-legal iOS screenshot.
quikgif shot --simulator-auto --output shot.png
--simulator captures no audio and has no interactive/tap behavior of its own - it is a
single frame, taken instantly. The focus-stealing caveat on the record --simulator
docs applies only to scripted taps during a recording,
not to shot.
Sizing
| Flag | Type | Default | Description |
|---|---|---|---|
--size | String | -- | Exact output size as WxH in pixels, e.g. 1242x2688 |
--fit | String | contain | How to reach --size: contain (pad, never distorts), cover (crop to fill), or stretch (distorts to fill) |
--pad-color | String | 000000 | Pad color for --fit contain, as RRGGBB hex |
--size resizes the captured still to exact pixel dimensions - the same App Store
screenshot-slot requirement record --size serves for video. contain never distorts the
image; it scales to fit and pads any leftover space with --pad-color. cover scales to
fill and center-crops the overflow. stretch scales each axis independently and can
distort the image.
Window Options
| Flag | Type | Default | Description |
|---|---|---|---|
--include-title-bar / --no-include-title-bar | Bool | true | Keep the real window title bar. Not applicable to --simulator or --region |
--title-bar-height | Int | 28 | Height in points to remove with --no-include-title-bar |
Output
| Flag | Type | Default | Description |
|---|---|---|---|
--format | String | png | Output format: png or jpeg |
--quality | Double | 0.9 | JPEG quality, 0.0 to 1.0. Ignored for PNG |
-o, --output | String | shot.png | Output file path |
-q, --quiet | Bool | false | Suppress progress output |
Examples
Capture the booted Simulator's native framebuffer:
quikgif shot --simulator-auto --output shot.png
Capture the booted Simulator, letterboxed to an exact App Store screenshot size:
quikgif shot --simulator-auto --size 1242x2688 --output 65.png
Capture a window at native resolution:
quikgif shot --app Terminal --output terminal.png
Capture a screen region as JPEG:
quikgif shot --region 0,0,1920,1080 --format jpeg --quality 0.85 --output region.jpg