C++ library for parsing the maps generated by the Map Editor called Tiled.
C C++ CMake
Latest commit 36ba307 Dec 10, 2016 @sainteos committed on GitHub Merge pull request #47 from AzP/master
Add C++11 requirement in CMakeLists.txt



This is a library for parsing the maps generated by Tiled Map Editor.

The TMX format is based upon XML and may contain compressed and encoded tile data to save memory and reduce file sizes. This parser uses the TinyXML library and its DOM interface to parse TMX files.

An example file is provided to understand how to use the library.

This project is forked from https://code.google.com/p/tmx-parser/ because:

  • Organized cleanly for inclusion into Debian. This means depending on zlib and TinyXML externally, building a shared library, installing to the correct prefix, etc.
  • Drop support for Android and Windows. If you want a Windows build, use mxe.
  • Resolving the open issues: https://code.google.com/p/tmx-parser/issues/list
  • More robust tests.


  • Conformity with the TMX specification page.
  • Decodes and decompresses tile data.
  • Can parse properties as both integers, real numbers and literals (strings).
  • Can parse the map file when stored in memory.
  • Does not rely on any graphics library.
  • Animated tile support.


  • zlib
  • TinyXML


mkdir build
cd build
cmake ..
sudo make install