Commands
Every subcommand has its own page. The CLI itself is gifgrep --help.
#Top-level
gifgrep <command> [flags]| Command | What it does |
|---|---|
gifgrep search | Search a provider; print URLs, JSON, or markdown. |
gifgrep tui | Interactive browser with inline animated previews. |
gifgrep still | Extract one frame from a GIF as PNG. |
gifgrep sheet | Generate a contact-sheet PNG of N frames. |
gifgrep <query> is shorthand for gifgrep search <query> — pick whichever feels natural.
#Global flags
--color <auto|always|never> color output
--no-color shorthand for --color=never
--reveal after a write, open the file/folder
-v / -vv verbose stderr
-q quiet stderr
--version print version and exit
-h / --help help (per-command when used after a subcommand)#Environment
| Variable | Meaning |
|---|---|
GIPHY_API_KEY | Required for --source giphy (and preferred by auto). |
KLIPY_API_KEY | Required for --source klipy / --source tenor. |
GIFGREP_SOFTWARE_ANIM | 1 to force software animation; 0 to disable. |
GIFGREP_CELL_ASPECT | Tweak preview cell aspect ratio (default 0.5). |
GIFGREP_INLINE | kitty / iterm / sixel / ansi / off — override protocol detection. |
#Related
- JSON output — stable envelope for scripts and agents.
- Providers — GIPHY vs KLIPY vs auto.
- Previews — Kitty / Ghostty / iTerm2 protocol details.