Godot Animated Image

A Godot 4 GDExtension for loading and playing GIF, APNG, and Animated WebP through one unified API.

Load animated images from files or memory buffers, detect formats by magic bytes, import them as Godot resources, and play them with AnimatedImagePlayer.

Features

• GIF, APNG, and Animated WebP support
• Unified animated-image loading API
• File and memory-buffer loading
• Magic-byte format detection
• AnimatedImagePlayer
• AnimatedImageTexture
• Editor importer for animated images
• APNG dispose / blend composition
• Animated WebP decoding through libwebp
• Legacy Godot-GIF APIs such as GIFTexture, GIFPlayer, GIFReader, and GIFWriter

Quick Start

1. Install the addon.
2. Enable Godot Animated Image in Project → Project Settings → Plugins.
3. Load an animated image:

var player := AnimatedImagePlayer.new()
add_child(player)

player.load_from_file("res://character.webp")
player.play()

You can also load animated image data directly from memory:

player.load_from_buffer(bytes)

Format Detection

Formats are detected using their binary signatures rather than relying only on file extensions.

This is useful for archives, custom asset formats, CHARX files, network data, and other memory-based workflows.

Platform Support

Current official platform support: Windows x86_64 only.

Other platforms are currently unsupported / unverified.

Compatibility

• Godot 4
• Minimum Godot version: 4.3
• GDExtension
• Windows x86_64

Attribution

This project is based on / forked from BOTLANNER/godot-gif.

The original project is licensed under the MIT License.

Third-party components include giflib, libwebp, and godot-cpp. See the included THIRD_PARTY_LICENSES.md for details.

Source Code

Full source code, documentation, and issue tracking are available on GitHub.