gifgrep

by Unknown v1.0.0

Gifgrep enables searching GIF providers like Tenor and Giphy directly from the command line or a terminal user interface (TUI). It facilitates downloading GIFs, extracting still frames, or creating sprite sheets for rapid review and sharing. Ideal for quickly grabbing visual content for documentation, PRs, or chat.

The tool supports various output formats including JSON for programmatic access and formatted strings for piping into other commands. It also offers features such as downloading GIFs to a designated directory, revealing the last downloaded file, and customizing the appearance of previews. Environment variables can be tweaked to adjust animation behavior and preview geometry.

What It Does

Searches GIF providers (Tenor/Giphy), allows browsing in a TUI, downloads GIFs, and extracts still frames or sprite sheets.

When To Use

When you need to quickly find, download, and extract content from GIFs for documentation, pull requests, or chat applications.

Inputs

Search queries (keywords), GIF source (Tenor/Giphy), API keys (optional), frame extraction parameters (time, frame count, columns, padding), output format (JSON, URL).

Outputs

Downloaded GIFs, extracted still frames (PNG), sprite sheets (PNG), JSON output of search results, URLs of GIFs.

Limitations

GIPHY_API_KEY is required for using the Giphy source. Software animation may be required for some terminals. Kitty/Ghostty are required for CLI still previews.

Installation

1. Ensure you have either brew or go installed.
2. If using brew, run: `brew install steipete/tap/gifgrep`.
3. If using go, run: `go install github.com/steipete/gifgrep/cmd/gifgrep@latest`.
4. Verify installation by running `gifgrep --version` in your terminal.

View Cline documentation

1. Open the Cursor IDE terminal.
2. Install gifgrep using brew: `brew install steipete/tap/gifgrep` OR install using go: `go install github.com/steipete/gifgrep/cmd/gifgrep@latest`.
3. Verify installation by running `gifgrep --version` in the terminal.

View Cursor IDE documentation

1. Ensure you have either brew or go installed.
2. If using brew, run: `brew install steipete/tap/gifgrep`.
3. If using go, run: `go install github.com/steipete/gifgrep/cmd/gifgrep@latest`.
4. Verify installation by running `gifgrep --version` in your terminal.

View Aider documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.