Install

gifgrep is a single Go binary. No background daemons. No config file. No telemetry.

#Homebrew (macOS, Linux)

brew install steipete/tap/gifgrep
gifgrep --version

This is the recommended path — brew upgrade will pick up new releases.

#go install

go install github.com/steipete/gifgrep/cmd/gifgrep@latest

You'll need Go ≥ 1.26 and $(go env GOPATH)/bin on your PATH.

#Pre-built binaries

Download for your platform from the latest release:

• macOS 13 or newer (darwin_amd64, darwin_arm64)
• Linux (linux_amd64, linux_arm64)

macOS release binaries are Developer ID signed by Peter Steinberger (team Y5PE65HELJ) and notarized by Apple, so direct downloads pass Gatekeeper. Source builds via go install do not carry this release signature.

Unpack, drop the binary on your PATH, done. Download SHA256SUMS alongside the archive to check its SHA-256 digest; it replaces the old per-archive .sha256 files.

#From source

git clone https://github.com/steipete/gifgrep.git
cd gifgrep
go build -o bin/gifgrep ./cmd/gifgrep
./bin/gifgrep --version

#Verify

gifgrep --version
gifgrep --help

If --version prints gifgrep 0.4.4, you're good. Continue to the Quickstart.

#API keys (one-time)

Pick a provider — see Providers for the full breakdown:

# GIPHY (preferred when set)
export GIPHY_API_KEY=your-key

# KLIPY (fallback / free tier)
export KLIPY_API_KEY=your-key

gifgrep does not write or persist these keys; it only reads them from the environment.