Turn a screen recording into a GIF for your docs
Convert a short MP4 screen recording into an animated GIF with 1FileTool — drop the clip, set a width, and embed the result in a README. Runs offline.
Your progress
Turn a short screen recording into an animated GIF you can paste straight into a README, a docs page, or a GitHub issue. With 1FileTool's MP4 to GIF tool it's one drag and one click — everything runs offline on your machine.
The badge above is a real run with the sample clip below. A GIF is usually bigger than the MP4 it came from — GIF has no real video compression — but it embeds anywhere, including places that can't play video at all. Keep clips short and widths modest.
What you'll need
- 1FileTool 1.10.0 or later on macOS (Apple Silicon or Intel), Windows, or Linux.
- A short clip — under about 10 seconds is ideal. MP4, MOV, AVI, MKV and WebM all work.
video-to-gif-for-docs.zip
Sample files · 562.4 KB
- demo-clip-expected.gif499.2 KB
- demo-clip.mp485.4 KB
The ZIP holds demo-clip.mp4, a synthetic 7-second recording you can follow along with, and demo-clip-expected.gif — the exact file 1FileTool produced from it, so you can sanity-check your output.
Protect your originals first
Replace source is ON by default: the output overwrites the original file and no backup is kept. Before following along, open Settings › General and turn Replace source off, or pick a separate output folder.
Steps
1. Open the MP4 to GIF tool
Launch 1FileTool, click Video in the sidebar, then choose MP4 to GIF from the Convert group.
2. Drop in your clip
Drag demo-clip.mp4 (or your own recording) onto the drop zone — it accepts MP4, MOV, AVI, MKV, WebM and GIF. MP4 to GIF works on one clip at a time.
3. Set the width
Under Resolution, set Width to 960 — big enough for a README, small enough to keep the GIF lean. Leave one side empty and the aspect ratio is preserved; leave the width blank and the GIF renders at 480 px wide.
4. Run it
Click Run on 1 video. A few seconds later the result card confirms the conversion, and <name>.gif lands in your output folder (~/Documents/1FileTool unless you changed it). The source clip is never modified.
5. Embed it
Reference the GIF like any image — in Markdown:
The result
The sample clip produced demo-clip.gif: 8 seconds at one frame per second, 1920×1440 at the default width.
One thing to know before you ship it: MP4 to GIF renders one frame per second. The result is a step-by-step sequence — ideal for "click here → menu opens" walkthroughs, but it won't look like smooth motion. For fluid movement, keep the embed an MP4.
If it didn't work
- The GIF is huge. That is normal — lower the width (try
720or480) and shorten the source clip. Those are the only two dials. - The GIF looks choppy. It's the one-frame-per-second renderer, not a bug. Split a long walkthrough into a few short GIFs.
- You can't find the output. Check
~/Documents/1FileTool, or the output folder shown in the output bar — converted files always land there, never next to the source. - On Linux, clicking the drop zone opens a folder picker. A known quirk in the file dialog — drag the clip straight onto the window instead.
Try next
Want to test the idea first? Convert a clip right here in the browser:
Try it in your browser
This tool also runs in the browser. Try it here first, then do a whole folder at once in the app.
Try MP4 to GIF Online
Real Browser ProcessingNo file selected
Original
Result
Browser processing runs locally and exports WebM, GIF, PNG, WAV, or VTT. The desktop app supports more formats, larger files, and faster batch workflows.
Related
Tools used