Back to Details

gifgrep

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

gifgrep

gifgrep

Use

gifgrep

to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.

GIF-Grab (gifgrep workflow)

Search → preview → download → extract (still/sheet) for fast review and sharing.

Quick start

```
gifgrep cats --max 5
```
```
gifgrep cats --format url | head -n 5
```

gifgrep search --json cats | jq '.[0].url'

```
gifgrep tui "office handshake"
```

gifgrep cats --download --max 1 --format url

TUI + previews

TUI:
```
gifgrep tui "query"
```
CLI still previews:
```
--thumbs
```
(Kitty/Ghostty only; still frame)

Download + reveal

```
--download
```
saves to
```
~/Downloads
```
```
--reveal
```
shows the last download in Finder

Stills + sheets

gifgrep still ./clip.gif --at 1.5s -o still.png

gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png

Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
Tune:
```
--frames
```
(count),
```
--cols
```
(grid width),
```
--padding
```
(spacing).

Providers

```
--source auto|tenor|giphy
```
```
GIPHY_API_KEY
```
required for
```
--source giphy
```
```
TENOR_API_KEY
```
optional (Tenor demo key used if unset)

Output

--json

prints an array of results (

id

,

title

,

url

,

preview_url

,

tags

,

width

,

height

)

```
--format
```
for pipe-friendly fields (e.g.,
```
url
```
)

Environment tweaks

```
GIFGREP_SOFTWARE_ANIM=1
```
to force software animation
```
GIFGREP_CELL_ASPECT=0.5
```
to tweak preview geometry

使用

gifgrep

搜索GIF提供商（Tenor/Giphy），在TUI中浏览结果，下载GIF并提取静帧或帧图。

GIF抓取（gifgrep工作流）

搜索 → 预览 → 下载 → 提取（静帧/帧图），快速完成查看与分享。

快速开始

```
gifgrep cats --max 5
```
```
gifgrep cats --format url | head -n 5
```

gifgrep search --json cats | jq '.[0].url'

```
gifgrep tui "office handshake"
```

gifgrep cats --download --max 1 --format url

TUI + 预览

TUI模式：
```
gifgrep tui "查询内容"
```
CLI静帧预览：
```
--thumbs
```
（仅支持Kitty/Ghostty终端；显示静帧）

下载 + 打开

```
--download
```
将文件保存至
```
~/Downloads
```
```
--reveal
```
在Finder中显示最后下载的文件

静帧 + 帧图

gifgrep still ./clip.gif --at 1.5s -o still.png

gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png

帧图：将采样帧拼接成单张PNG网格（非常适合快速查看、文档、PR和聊天场景）。
自定义参数：
```
--frames
```
（帧数）、
```
--cols
```
（网格宽度）、
```
--padding
```
（间距）。

提供商

```
--source auto|tenor|giphy
```
使用
```
--source giphy
```
时需要
```
GIPHY_API_KEY
```
```
TENOR_API_KEY
```
为可选参数（未设置时将使用Tenor演示密钥）

输出

```
--json
```
打印结果数组（包含
```
id
```
、
```
title
```
、
```
url
```
、
```
preview_url
```
、
```
tags
```
、
```
width
```
、
```
height
```
）
```
--format
```
输出便于管道处理的字段（例如
```
url
```
）

环境变量配置

```
GIFGREP_SOFTWARE_ANIM=1
```
强制启用软件动画
```
GIFGREP_CELL_ASPECT=0.5
```
调整预览几何比例