gifgrep

gifgrep은(는) 무엇을 하나요?

gifgrep를 사용하여 GIF 제공자(Tenor/Giphy)를 검색하고, TUI에서 탐색하며, 결과를 다운로드하고, 스틸 또는 시트를 추출합니다.

GIF-Grab (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 "query"
• 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)

GIF 자산 위생

• 애니메이션 GIF URL을 추천하거나 사용하기 전에, 해당 URL이 성공적으로 확인되고, Content-Type: image/gif이며, 실제로 애니메이션인지(여러 프레임 또는 루프 메타데이터; 예: file, identify 또는 작은 스크립트로 검사) 확인하십시오.
• 자산과 함께 출처/라이선스/소스 URL을 기록하십시오.
• 로컬 자산이 필요한 경우 핫링크하지 말고: 프로젝트에 다운로드/복사하고 로컬 파일을 참조하십시오.

환경 조정

• GIFGREP_SOFTWARE_ANIM=1 소프트웨어 애니메이션 강제 사용
• GIFGREP_CELL_ASPECT=0.5 미리보기 지오메트리 조정