Tiled is a generic tile map editor
C++ Java Other
Pull request Compare This branch is 3 commits ahead, 2290 commits behind bjorn:master.
Failed to load latest commit information.
dist Moved the distribution scripts into the 'dist' directory May 22, 2011
docs Updated the DTD that describes the TMX format Jun 6, 2011
examples Merge branch 'master' of git://github.com/bjorn/tiled Jun 11, 2011
src Fixed linetool on hexagonal maps Jun 11, 2011
tests Tests for Automapping Apr 10, 2011
translations Merge branch '0.6' May 11, 2011
.LICENSE-HEADER Use the file name placeholder in the license header template Dec 11, 2010
.mailmap Using my full name from now on Jun 18, 2009
AUTHORS Removed the isometric tiles of which the origin is unknown Jun 10, 2011
COPYING Changed the license of libtiled and tmxviewer from GPL to BSD Dec 27, 2010
LICENSE.BSD Changed the license of libtiled and tmxviewer from GPL to BSD Dec 27, 2010
LICENSE.GPL Changed the license of libtiled and tmxviewer from GPL to BSD Dec 27, 2010
NEWS Bumped version to 0.6.2 May 1, 2011
README.md Noted that on Ubuntu, libqt4-opengl-dev needs to be installed May 8, 2011
tiled.pri Fixed mac compilation for any SDK. Jun 2, 2011
tiled.pro Require at least Qt 4.6 Feb 4, 2011


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.

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 offers many opportunities to improve the performance and usability of the user interface, and has a more extensive feature set than the standard Java libraries.

In starting from scratch, we'll also try to do some things better than they are done in the original Tiled. For example we will try to not only use input/output plugins, but anything from brushes to object types and maybe even map views may be possible to provide via a plugin. Plugins may also be able to provide parts of the user interface.


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

  • In Ubuntu/Debian: sudo apt-get install libqt4-dev libqt4-opengl-dev
  • In Fedora: yum install qt-devel
  • In Arch Linux: pacman -S qt

Now you can compile by running:

$ qmake (or qmake-qt4 on some systems, like Fedora)
$ 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