🦀 gifmeta

gifmeta is a small, fast, and sacred tool for inspecting and editing GIF metadata.
Use it to extract loop counts, view frame delays, and set precise timing — all from the command line or via Rust.

❤️ Built with love and clarity. No unnecessary bloat.

✨ Features

🔍 Inspect frame count, size, and duration
🔁 View and modify loop counts
🕰️ Show per-frame delays (preview timing)
🎯 Set a fixed delay across all frames
🎯 Prepare for per-frame delay editing (coming in v0.3.0)

📦 Installation

Install via crates.io!:

cargo install gifmeta

Or use directly with:

cargo run -- <command>

Install via GitHub

git clone https://github.com/madspaaskesen/gifmeta.git
cd gifmeta
cargo build --release
./target/release/gifmeta --help

🛠️ Usage

Show metadata

gifmeta info --input input.gif

Get loop count

gifmeta get-loop --input input.gif

Set loop count

gifmeta set-loop --input input.gif --count 3 --output out.gif

Show all frame delays

gifmeta show-frame-delays --input input.gif

Set delay for all frames

gifmeta set-delay --input input.gif --delay 10 --output out.gif

Set frame specific delays

gifmeta set-frame-delay --input input.gif --frame-numbers 1,5,80 --delay-values 10,20,100 --output out.gif

🛠 Commands

Command	Description
`info`	Show basic metadata (frames, size, delay)
`get-loop`	Get the loop count from a GIF
`set-loop`	Set the loop count (use `0` for infinite)
`show-frame-delays`	Display the delay of every frame
`set-delay`	Apply a fixed delay to all frames
`set-frame-delay`	Set custom delays for specific frames

🧠 Why This Exists

GIFs are still everywhere — especially in messaging, memes, and UI loaders. But modifying timing or loop behavior often requires heavy tools.

gifmeta lets you do it instantly, with:

🦀 Native Rust speed
🧼 Zero bloat
🖥️ CLI-first ergonomics

🛤️ Roadmap

Set loop count (v0.2.0)
CLI structure with clap v4
Set per-frame delays (v0.3.0)
Frame editing with duration visuals (experimental)
GUI Companion (Tauri, optional)

⚠️ Batch processing and WASM are intentionally skipped.
These are best handled externally with scripting or shell tooling.

👩‍💻 Contributing

Wanna help? Fork, clone, and PRs welcome. You can also suggest Codex tasks or open issues 💛

gifmeta 0.2.0