Tilemap2Animation is a command-line tool that converts a Tiled tilemap (TMX) into an animated GIF, allowing you to transform tile-based designs from Tiled and other game development tools into seamless animated GIFs.
- TMX to GIF Conversion - Convert Tiled tilemaps directly into animated GIFs
- Automatic File Resolution - Automatically finds related TMX, TSX, and image files
- Animation Generation - Creates smooth animations from tilemap layers
- Frame Delay Control - Customize animation timing for the perfect result
- Only orthographic maps are supported at this time
- Only GIF output format is available
Convert a tileset and tilemap into a GIF animation:
| From | To |
|---|---|
 |
 |
- Ensure you have .NET 10 runtime installed.
- Download the latest release from the releases page.
- Extract the zip file to your preferred location.
tilemap2animation -i <input file> -o <output GIF file>
The input file can be:
- A TMX tilemap file
- A TSX tileset file
- A tileset image file (the tool will try to find related TMX and TSX files)
For a full list of options, use:
tilemap2animation --help
For converting GIFs back to tilemaps, check out Animation2Tilemap.
If you find value in this project, there are several ways you can contribute:
- Give the project a star on GitHub.
- Support the project through GitHub Sponsors.
- Improve documentation, report bugs, or submit pull requests.
Tilemap2Animation is open-source software licensed under the MIT License.