Convert Lottie to GIF for a GitHub README
Turn a Lottie demo or logo animation into a GIF that actually animates on GitHub — READMEs strip scripts and SMIL, GIF just works.
How it works
- 1Upload a Lottie file (.json, .lottie, or .tgs), or try the example
- 2Adjust frame rate, quality, resolution and transparency
- 3Export to any format — or optimize and repackage as dotLottie
Nothing is uploaded. SVG output uses SMIL and needs no JavaScript; APNG and WebM keep the full color and transparency GIF can't.
About using Lottie GIFs in a GitHub README
GitHub sanitizes READMEs: no JavaScript, no embedded players, and even animated SVGs get frozen. The reliable way to put motion in a README is an animated image — GIF plays everywhere GitHub renders markdown, and APNG works too with full color.
Convert your Lottie here, commit the GIF to your repo (or attach it to an issue to get a CDN URL), and embed it with standard image markdown. A transparent GIF adapts to GitHub's light and dark themes; keep the file lean so your README stays fast to load.
Which format should I use?
| Format | Type | Transparency | Color | Best for |
|---|---|---|---|---|
| GIF | Animated image | 1-bit (hard edges) | 256 colors | Email, chat, universal support |
| APNG | Animated image | 8-bit (smooth) | Full 24-bit | Icons, logos, quality over size |
| WebM | Video | Yes (VP9 alpha) | Full | Small web video, transparent overlays |
| MP4 | Video | None | Full | Social, ads, video editors |
| SVG | Vector (SMIL) | Yes | Full | Runtime-free embeds |
| PNG / WebP | Still image | Yes | Full | Posters, thumbnails, placeholders |
Frequently asked questions
Why doesn't my animated SVG play in the README?+
GitHub's sanitizer strips SMIL/scripts from embedded SVGs — they render as a static frame. Use GIF or APNG instead.
GIF or APNG for GitHub?+
Both animate in READMEs. GIF is the battle-tested default; APNG gives smoother alpha and full color at sometimes larger sizes.
How do I embed it?+
Commit the file and reference it:  — or drag it into an issue comment and reuse the generated URL.
