Skip to content
A generic tile map editor
C++ Java Python QML C QMake Other
Latest commit ceacaf5 Jun 19, 2016 @bjorn Session Management: Hook up the commitDataRequest signal
It seems that I simply forgot this many years ago. Since Qt 5.6, there
is a default session management, but it may be better to handle it
manually. Now, this needs to be explicitly disabled in order to avoid it
from interfering.
Failed to load latest commit information.
.tx Added Transifex configuration Jan 27, 2013
dist Qbs: Require at least version 1.5.0, removed WiXModule hack Jun 6, 2016
docs Addition of SKTilemap (#1299) Jun 8, 2016
docs_theme Updated Tiled forum URL Apr 20, 2016
examples Added custom property type 'color' May 13, 2016
man Free up 'docs' directory for actual documentation May 20, 2015
mime Free up 'docs' directory for actual documentation May 20, 2015
qbs/imports Qbs: Enabled building a binary package for Linux May 22, 2016
src Session Management: Hook up the commitDataRequest signal Jun 19, 2016
tests cygwin workaround Jan 4, 2016
translations Merge branch '0.16' May 30, 2016
util/java correct the index of csvTileIds Mar 9, 2016
.LICENSE-HEADER Update license year to 2016 Jan 17, 2016
.gitattributes Merge branch '0.9' Jul 26, 2013
.gitignore .gitignore updates Nov 30, 2015
.mailmap Update .mailmap file Apr 27, 2013
.travis.yml TravisCI: Enabled OSX builds Mar 5, 2016
AUTHORS Merge branch '0.16' Apr 30, 2016
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 Automapping: Fixed a painting related bug affecting the top edge Jun 19, 2016
README.md Added LiveCoding.tv badge Apr 14, 2016
appveyor.yml AppVeyor: Use Qt 5.6 for the 32-bit MinGW builds Jun 12, 2016
mkdocs.yml docs: Added a page about custom properties Mar 25, 2016
tiled.appdata.xml Free up 'docs' directory for actual documentation May 20, 2015
tiled.desktop Free up 'docs' directory for actual documentation May 20, 2015
tiled.pri Updated NEWS.md and bumped version to 0.16.2 Jun 12, 2016
tiled.pro Updated minimum required Qt version to 5.2 Jun 5, 2016
tiled.qbs Qbs: Fixed default version Jun 19, 2016

README.md

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 LiveCoding.tv

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.

Compiling

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

  • In Ubuntu/Debian: apt-get install qt5-default qttools5-dev-tools zlib1g-dev libqt5opengl5-dev
  • In Fedora: yum install qt-devel
  • In Arch Linux: pacman -S qt
  • In Mac OS X with Homebrew:
    • brew install qt5
    • brew link qt5 --force

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.

Installing

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.

Something went wrong with that request. Please try again.