A typing GIF can show a short build message or command without asking a reader to play a video. The useful part is not the animation alone: the text needs enough time to be read, the file needs to be small, and the loop should behave as you expect in the place where you embed it.
This walkthrough makes a small terminal-style example and checks the exported GIF with Python. The exact frame count and file size depend on the message and settings you choose.
Create the typing animation
Open LoopGIF's typing text GIF maker. I work with the team behind LoopGIF; AI assistance was used to draft this tutorial. The page describes this particular editor as free and says it renders the GIF in the browser.
For the example, use these settings:
- Enter
BUILD COMPLETEas the text. - Start with the Terminal style and leave the canvas at 480 × 270.
- Set the typing speed to 12 characters per second and the end hold to 1.5 seconds.
- Select the block cursor, enable its blink, and enable Delete and retype.
- Check the preview, then choose Download GIF.
In the test export, the page reported 30 frames, approximately 3.1 seconds and an estimated size of 25 KB. The downloaded file measured 26,774 bytes. Those are measurements of this example, not a promise for every export.
Check the exported GIF with Python
If you have Python and Pillow installed, save this as inspect_gif.py:
import sys
from pathlib import Path
from PIL import Image, ImageChops, ImageSequence
path = Path(sys.argv[1])
with Image.open(path) as image:
size = image.size
loop = image.info.get("loop")
frames = []
durations = []
for frame in ImageSequence.Iterator(image):
durations.append(frame.info.get("duration", 0))
frames.append(frame.convert("RGB").copy())
difference = ImageChops.difference(frames[0], frames[-1]).getbbox()
print(f"Size: {size[0]} × {size[1]}")
print(f"Frames: {len(frames)}")
print(f"Total duration: {sum(durations)} ms")
print(f"Loop value: {loop}")
print(f"First/last difference: {difference}")
print(f"File size: {path.stat().st_size} bytes")
Run python inspect_gif.py path/to/typing-text.gif. If Pillow is missing, install it in the Python environment you use for this check: python -m pip install Pillow.
For this file, Pillow reported 480 × 270, 30 frames, 3,140 ms and a loop value of 0, which means infinite looping in the GIF. The first and last frames differed in a small rectangle. That does not by itself mean the animation is broken: a blinking cursor or a letter appearing at the loop boundary can create a difference. Watch the exported file in its intended viewer before deciding whether the transition is acceptable.
Make the result easier to read
Keep the message short enough to fit without shrinking it to an unreadable size. Use the hold setting to give readers time to see the completed line. If the ending feels abrupt, try a longer hold, turn off cursor blinking, or compare a version with Delete and retype disabled. Export each variant and check the result; a slower animation is not automatically a smaller file.
For a transparent background, test it on the actual page color. GIF transparency is binary, so the edge color used around text can show as a halo on a contrasting background. The editor explains this limitation in its on-page notes.
Add it to a README
If the hosting service supports animated GIFs in Markdown, add the exported file to your project and reference it with a relative path:

Open the rendered README and verify that the animation plays, the text is legible and the file path is correct. Some viewers reduce or disable animation, so keep important instructions in ordinary text as well.
Questions
Does the animation have to loop forever?
No. Choose the loop behavior that fits the destination. The example above uses the editor's infinite-loop setting.
Why does the final file size differ from the preview?
The displayed size is an estimate. The exported GIF has its own measured size, which can change with dimensions, colors and frame content.
Are matching first and last frames required?
Not always. They are a useful diagnostic for a visually continuous loop, but an intentional cursor blink or typing transition may differ. Inspect the animation rather than treating the pixel comparison as a pass-or-fail quality score.
What should I put in the alt text?
Describe the information the animation conveys. A screen reader does not need a frame-by-frame account of a decorative cursor.
Top comments (0)