gifgrep

gifgrep

Инструмент для поиска GIF из провайдеров (Tenor / Giphy) с поддержкой CLI и TUI, скачивания результатов и извлечения отдельных кадров или сеток изображений.

Что это такое

gifgrep — это утилита командной строки, которая позволяет быстро находить GIF-анимации, просматривать их прямо в терминале и работать с ними как с обычными данными. Поддерживаются два режима: скриптовый CLI и интерактивный TUI-интерфейс с предпросмотром.

Инструмент ориентирован на быстрый workflow: поиск → предпросмотр → скачивание → извлечение кадров.

Основные возможности

• Поиск GIF через Tenor и Giphy
• Работа через CLI (подходит для пайпов и автоматизации)
• Интерактивный TUI с анимированными превью
• Скачивание GIF в локальную систему
• Извлечение отдельных кадров (still)
• Генерация сетки кадров (sheet)
• JSON-вывод для интеграций

Быстрый старт

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-режим предоставляет удобный браузер внутри терминала с возможностью просмотра GIF-анимаций прямо в интерфейсе. Это делает выбор нужного файла значительно быстрее.

В CLI-режиме доступны статические превью (один кадр), которые можно включить через соответствующие параметры.

gifgrep tui "query"
gifgrep cats --thumbs

Скачивание и открытие

• --download — сохраняет GIF в папку Downloads
• --reveal — показывает файл в файловом менеджере

Извлечение кадров

gifgrep умеет не только искать GIF, но и преобразовывать их в удобные статические форматы.

gifgrep still ./clip.gif --at 1.5s -o still.png
gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png

Сетка (sheet) — это PNG с набором кадров, что удобно для документации, обзоров или чатов.

Провайдеры

• auto — автоматический выбор (по умолчанию)
• tenor — использует Tenor
• giphy — требует API-ключ

Для работы с Giphy необходимо указать переменную окружения GIPHY_API_KEY, тогда как Tenor может использовать демо-ключ.

Форматы вывода

• --json — возвращает структурированный JSON
• --format — позволяет выбрать нужные поля (например, только URL)

Это делает инструмент удобным для интеграции в пайплайны и автоматические сценарии. :

Итог

gifgrep — это компактный, но мощный инструмент для работы с GIF-контентом из терминала. Он объединяет поиск, просмотр, скачивание и обработку в одном CLI/TUI-инструменте, ускоряя работу с визуальным контентом для разработчиков и команд.