Skip to main content

quikgif list-windows

List all capturable windows grouped by application. Use this to find window IDs for the --window flag on quikgif record.

quikgif list-windows

No flags -- the command lists all visible windows with non-zero dimensions.

Output Format​

ID      Application                     Title                                               Size
──────────────────────────────────────────────────────────────────────────────────────────────────────
1234    Terminal                        ~/Projects — zsh                                    1200×800
5678    Safari                          Apple Developer Documentation                       1440×900
9012    VS Code                         main.swift — QuikGIF                                1600×1000

Columns:

  • ID -- the window ID to pass to quikgif record --window
  • Application -- the owning app name
  • Title -- the window title (or "(untitled)")
  • Size -- width x height in points
info

This command requires Screen Recording permission. If it fails, grant permission to your terminal app in System Settings > Privacy & Security > Screen Recording.

Example Usage​

Find the window ID for a specific app, then record it:

quikgif list-windows
# Find the ID for your target window, e.g. 1234

quikgif record --window 1234 --duration 10 -o demo.gif