https://github.com/vonhoff/tilemap2animation
A tool that converts a tilemap to GIF
https://github.com/vonhoff/tilemap2animation
gamedev gif-animation gif-creator gif-maker tiled tiled-map-editor tilemaps tilesets
Last synced: 3 months ago
JSON representation
A tool that converts a tilemap to GIF
- Host: GitHub
- URL: https://github.com/vonhoff/tilemap2animation
- Owner: vonhoff
- License: mit
- Created: 2025-05-16T18:58:12.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2025-06-03T07:46:03.000Z (4 months ago)
- Last Synced: 2025-06-30T22:17:53.321Z (3 months ago)
- Topics: gamedev, gif-animation, gif-creator, gif-maker, tiled, tiled-map-editor, tilemaps, tilesets
- Language: C#
- Homepage:
- Size: 1.83 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Tilemap2Animation
[](https://github.com/vonhoff/TilemapToAnimation/releases)
[](LICENSE)
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](https://www.mapeditor.org/) and other game development tools into seamless
animated GIFs.
## Features
- **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
## Limitations
- Only orthographic maps are supported at this time
- Only GIF output format is available
## Example
Convert a tileset and tilemap into a GIF animation:
| From | To |
|:------------------------------------------------------:|:---------------------------------------------------:|
|  | 
|
## Getting Started
### Installation
1. Ensure you have [.NET 10 runtime](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) installed.
2. Download the latest release from the [releases page](https://github.com/vonhoff/TilemapToAnimation/releases).
3. Extract the zip file to your preferred location.
### Usage
```
tilemap2animation -i -o
```
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
```
## Related Projects
For converting GIFs back to tilemaps, check out [Animation2Tilemap](https://github.com/vonhoff/Animation2Tilemap).
## Support and Contribute
If you find value in this project, there are several ways you can contribute:
- Give the [project](https://github.com/vonhoff/Tilemap2Animation) a star on GitHub.
- Support the project through [GitHub Sponsors](https://github.com/sponsors/vonhoff).
- Improve documentation, report bugs, or submit pull requests.
## License
Tilemap2Animation is open-source software licensed under the [MIT License](LICENSE).