C++ Java Python QML C QMake Objective-C++
Failed to load latest commit information.
.tx Added Transifex configuration Jan 27, 2013
dist OS X: Use the Qt 5.8 macdeployqt tool May 25, 2017
docs docs: Fixed link to other page Jun 19, 2017
examples Support 60 degree rotation for hexagonal maps (#1447) Mar 7, 2017
man tmxrasterizer: Added --size argument and support local file URLs Sep 26, 2016
mime Merge branch 'master' into wip/tilesetdocument Oct 28, 2016
qbs/imports Qbs: Added an option to disable the use of RPATH Mar 14, 2017
src Fixed tool tips on flipping and rotating stamp actions Jun 27, 2017
tests Added a few maps for testing of error handling Dec 6, 2016
translations Translated using Weblate (Chinese) Jun 13, 2017
util/java libtiled-java: Fixed wrong exception being caught in TileSet (#1629) Jun 26, 2017
.LICENSE-HEADER Updated copyright year in About dialog Feb 7, 2017
.gitattributes Merge branch '0.9' Jul 26, 2013
.gitignore Added executables in tests directory to .gitignore (#1485) Mar 14, 2017
.mailmap Updated AUTHORS file Jun 12, 2017
.travis.yml Merge branch '0.18' Feb 21, 2017
AUTHORS Updated AUTHORS file Jun 12, 2017
CONTRIBUTING.md Tweaked donation link Feb 28, 2017
COPYING Updated license information in COPYING file Aug 16, 2015
Doxyfile Free up 'docs' directory for actual documentation May 20, 2015
LICENSE.APACHE Replica Island plugin: Read and write *.bin files Mar 11, 2012
LICENSE.BSD Changed the license of libtiled and tmxviewer from GPL to BSD Dec 27, 2010
LICENSE.GPL Updated the GPLv2 license to its latest version Sep 2, 2012
NEWS.md Bumped version to 1.0.2 and updated NEWS file Jun 27, 2017
README.md Removed broken livecoding.tv badge Mar 22, 2017
appveyor.yml AppVeyor: Revert back to Qbs 1.7.2 for now Jun 13, 2017
mkdocs.yml docs: Added a page about working with objects Apr 25, 2017
tiled.appdata.xml Added keywords to the appdata file Sep 25, 2016
tiled.desktop Added MIME type for tileset files Oct 14, 2016
tiled.pri Bumped version to 1.0.2 and updated NEWS file Jun 27, 2017
tiled.pro Fixed encoding problems with command-line output Jan 13, 2017
tiled.qbs Bumped version to 1.0.2 and updated NEWS file Jun 27, 2017


Tiled Map Editor - http://www.mapeditor.org/

About Tiled

Tiled is a general purpose tile map editor. It is meant to be used for editing maps of any tile-based game, be it an RPG, a platformer or a Breakout clone.

Tiled is very flexible, for example there are no restrictions on map size, tile size or the number of layers or tiles. Also, it allows arbitrary properties to be set on the map, its layers, the tiles or on the objects. Its map format (TMX) is relatively easy to understand and allows a map to use multiple tilesets while also allowing each tileset to grow or shrink as necessary later.

Build Status Build status Bountysource Translation status

About the Qt Version

Tiled was originally written in Java. In 2008 the Qt version was started with the goal to replace the Java version with a faster, better looking and even easier to use map editor. Qt offered many opportunities to improve the performance and usability of the user interface, and has a more extensive feature set than the standard Java libraries.


Make sure the Qt (>= 5.4) development libraries are installed:

  • In Ubuntu/Debian: apt-get install qt5-default qttools5-dev-tools zlib1g-dev
  • In Fedora: sudo dnf builddep tiled
  • In Arch Linux: pacman -S qt
  • In Mac OS X with Homebrew:
    • brew install qt5
    • brew link qt5 --force
  • Or you can download Qt from: https://www.qt.io/download-open-source/

Now you can compile by running:

$ qmake (or qmake-qt5 on some systems)
$ make

To do a shadow build, you can run qmake from a different directory and refer it to tiled.pro, for example:

$ mkdir build
$ cd build
$ qmake ../tiled.pro
$ make

You can now simply run Tiled using bin/tiled.


For installing Tiled you can run make install. By default Tiled will install to /usr/local. You can change this prefix when running qmake, and/or you can change the install root when running make install, as follows:

Use /usr instead of /usr/local:

$ qmake -r PREFIX=/usr

(Recursive needed when it's not the first time that you're running qmake, since this affects nested pro files)

Install to some packaging directory:

$ make install INSTALL_ROOT=/tmp/tiled-pkg

By default, Tiled and its plugins are compiled with an Rpath so that they can find the shared libtiled library when running it straight after compile. When packaging for a distribution, this Rpath should generally be disabled by appending RPATH=no to the qmake command.