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.22 and $(go env GOPATH)/bin on your PATH.

#Pre-built binaries

Download for your platform from the latest release:

• macOS (darwin_amd64, darwin_arm64)
• Linux (linux_amd64, linux_arm64)
• Windows (windows_amd64.zip)

Unpack, drop the binary on your PATH, done.

#From source

git clone https://github.com/steipete/gifgrep.git
cd gifgrep
make build       # builds ./bin/gifgrep
./bin/gifgrep --version

#Verify

gifgrep --version
gifgrep --help

If --version prints something like gifgrep 0.2.x, 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.