initial commit

README.md

@@ -0,0 +1,31 @@
+# GIF Frame Extractor (Go)
+
+A small, fast Go CLI tool that extracts frames from an animated GIF and saves them as PNG files.
+
+It supports:
+- **Raw frame extraction** (exact stored frames)
+- **Composited frame rendering** (what you visually see when the GIF plays)
+- **Shorthand and long CLI flags**
+- Correct handling of GIF **disposal methods**
+
+---
+
+## Features
+
+- 🚀 Fast and dependency-free (pure Go standard library)
+- 🖼️ Export each GIF frame as a PNG
+- 🎞️ Correct visual compositing using GIF disposal rules
+- 🧩 Optional raw frame dumping (no compositing)
+- 🔤 Short and long command-line flags
+
+---
+
+## Installation
+
+### Build from source
+
+```bash
+git clone https://github.com/mr0xb/gif2png.git
+cd gif2png
+go build -o gif2png
+