gifithabibi

The problem

I wanted to turn my screen recordings into GIFs, mostly for GitHub issues, but I couldn't find a good, free, open-source solution.

So I created gifithabibi. Download the binary, pass it your screen recording, and it will convert it into an optimized GIF:

./gifithabibi recording.mov

Platform: gifithabibi primarily targets macOS. Other platforms are currently untested.

Usage

Make sure FFmpeg is installed as its required:

brew install ffmpeg

chmod +x gifithabibi
./gifithabibi input.mov

Options

Defaults are 15 FPS, 64 colors, and the original dimensions when possible. If the GIF is larger than the input, smaller scales are tried automatically while preserving the aspect ratio.

./gifithabibi -f 15 -s 75 -o demo.gif input.mov

• -f — frame rate; cannot exceed the input frame rate
• -s — scale percentage from 10 to 100
• -o — output GIF path

Development

Build from source

Requires Bun:

bun install
bun run build

The Bash implementation is also available independently:

./src/gifithabibi.sh input.mov