Tiled2Unity is on GitHub

by Seanba on February 15, 2015


Update: Tiled2Unity is now officially supported on Mac and Linux platforms as a command line utility through Tiled2UnityLite.


In keeping with my decision to keep Tiled2Unity free and choosing the permissive MIT License for it I have recently put all the source up on a public GitHub repository.

Full disclosure: I’m new to GitHub so bear with me if I make a mess of it. I’m a long-timer user of Perforce and Subversion and have been a bit of a dinosaur when it comes to Git.

Tiled2Unity on GitHub

{ 27 comments… read them below or add one }

Brock February 17, 2015 at 7:10 pm

Please someone make a Mac version!

Anonymous March 6, 2015 at 2:41 pm

Few changes are needed to make Tiled2Unity work on linux with mono. Probably a mac “version” should need no aditional changes. I have made a fork on GitHub here:


The build can be downloaded here:


Anyone who wants to try it on linux or a mac, just download the .zip and run the .exe. Since this is a dotnet app, it should run unmodified in every platform, be it windows, linux or mac

Seanba March 7, 2015 at 5:48 pm

Thanks, Gnumaru. If someone can confirm this works on Mac then I will make a new post alerting users to your fork for Linux and Mac development.

Arlefreak March 30, 2015 at 4:59 pm

Hi i tested this today on a Macbook pro and it worked! you only need to install mono:

Then run on your terminal
mono Tiled2Unity.exe
Inside the folder you downloaded 🙂 Thanks!

tikilittle April 3, 2015 at 4:15 pm

The Mac version works. Here’s a step-to-step guide for how I got it to work with the example.
Following Arlefreak’s above method:
1) Install Mono
2) Import package “Tiled2Unity.unitypackage” into your project
3) Go File > “Open Tiled File…”
4) Find the “minimalist.tmx” file
5) Click on “Choose Export Folder” and find the folder top level folder above the “Assets” folder for your project (NOTE: it will not work if you set the path to a folder within the project).
6) Click on the Export button
7) Go back to your Unity package and check the Tiled2Unity/Prefabs folder

fatsopanda April 23, 2015 at 1:13 am

Hola Mac users! I tried the above tips but am getting an error: System.IO.FileNotFoundException: Could not load file or assembly ‘PresentationCore, Version=, Culture=neutral, PublicKeyToken=31bf3856ad364e35’ or one of its dependencies.

Quick searching revealed that this error would be related to a .NET version (at least if you get this error in Windows). Did you install anything else before installing tiled2unity via mono? I’m on OSX X Yosemite 10.10.3. Would be great to get this working 🙂

Jgar April 27, 2015 at 5:50 am

@fatsopanda and anybody else who experiences a similar problem. Make sure that you download the build that was posted in the comment it should be a zip file titled Tiled2UnityTool.

If the link below does not work use the similar link posted earlier.

dave April 29, 2015 at 6:19 am

doesn’t work on yosemite.

dave April 29, 2015 at 6:29 am

It’s working. Takes time.

sudo mono -v Tiled2Unity.exe

Aaryan June 5, 2015 at 1:23 am

@Jgar I downloaded the zip from your link and was successfully able to open the windows file using wine (the reason I used yours was because the one the developer made crashed when I used wine). Once I opened it and followed the step by steps and I was about to press the button “open” for my tile file the thing would crash. What should I do?

GX June 6, 2015 at 3:29 pm

I’m following the instructions above, but when I try to import the package into my project by help->Import unity package to project nothing is happening. I tried importing the package from the Unity GUI, but could not find “Tiled2Unity.unitypackage”. Any advice? Running OS X 10.10.3.

Seanba sez: Hi GX, I haven’t tried importing on Mac but the Tiled2Unity.unitypackage file is included in the zip file on the download page.

GX June 7, 2015 at 11:12 pm

Thanks Seanba! I still must be missing something, because I am only seeing 4 .dll’s and Unity2Tiled.exe in the in the zip file.

Tim June 9, 2015 at 3:35 am

The OSX version only partially works. I’m able to export using Mono, but the exported tiles in-game have white outlines around them. Strange.

The OSX build also needs to be updated with the latest T2U build.

Tim June 9, 2015 at 11:49 am

Updated it here with the newest version: Seems to work fine now. I had to scale the collision layers x2 for some reason though.

To use:
1. Go to https://github.com/timminkov/Tiled2Unity
2. Download the Zip or clone the repo.
3. Use the exe in Tiled2Unity/tool/Tiled2Unity/src/bin/Debug/ as per instructions above (I use Mono, Wine didn’t work for me).

GX June 9, 2015 at 8:25 pm

Ah found it thought you were referring to the zip above before. Works great!!

Ruben June 12, 2015 at 10:37 am

Works very well in MAC Yosemite!

Nathan June 20, 2015 at 9:28 pm


Following the above, I can get Tiled2Unity opening in OSX. However, when I brows for the tiled file to Open, I cannot seem to access the local directory. Seems when I try to open the file, I can only browse a very ’empty’ folder structure.

Pat June 27, 2015 at 12:05 pm

I’m able to run the program using the repo Tim linked to (but not the other one), but when I try to navigate the file directory, it doesn’t look anything like my actual directory and I’m not able to navigate to the .tmx file. Any suggestions?

Christian July 13, 2015 at 5:40 pm

@Nathan and @Pat
I had the same issue running through mono. I was able to find my directories by pressing the green arrow that points up with a line under it in the import directory window. I just kept clicking it until it brought me to my desktop where my folder of .tmx files were.

Hope that helps!

Christian July 13, 2015 at 5:55 pm

Though now I am trying to export the map it won’t let me find my way back to my actual Desktop…
Any help/suggestions?

Christian July 13, 2015 at 9:03 pm

Hey guys, I figured out my issue. My problem was using the Tiled2Unity.exe in Tiled2Unity/tool/Tiled2Unity/src/bin/Debug/ .
Instead I used “Tiled2Unity-master/tool/Tiled2Unity/build/Tiled2UnityTool” (the folder is from the zip downloaded from an above link).
Once you’ve changed the directory use “mono Tiled2Unity.exe”. This seems to have completely solved my directories issue.
(I also put together a quick Automator application to quickly get it up and running without opening terminal).

DavR July 15, 2015 at 7:58 pm

I am having a hard time trying to figure out how to get tiled2unity to work for mac. I tried following the posts on here, but some steps are over my head. I am also not sure how to navigate files using the Terminal. I drag and dropped the .exe in terminal and it showed the path. I hit “return” to run it, but I received an error.

Jesse A July 30, 2015 at 11:00 pm

This is how I did it and it seems to be working great.
1) Download mono here:

2) Download the updated Tiled2Unity files here:

3) This is the important part here… Go to your downloads folder and open up the folder you just downloaded called “Tiled2UnityTool”.

4) Grab all those files (starts with Ookii.Dialogs.Modified.dll and the last one is Tiled2Unity.exe) and place them in your home folder. You need to either drag and drop them there or copy and paste them there. The home folder for me is the last folder in my Finder under my favorites off to the left hand side.

5) Once all the files are there you need to open up the Terminal window. An easy way to find the terminal is to click the magnifying glass that is at the top right of your Mac. When the search feature opens up type “Terminal” and it will be the first thing that pops up.

6) In the terminal window type mono Tiled2Unity.exe then press enter
You should now see the Tiled2Unity software open up. Sadly you are no ready to use it yet.

7) Next you need to go online to github. https://github.com/Gnumaru/Tiled2Unity
Once you are there on the right hand side in the middle click “Download Zip”

8) Once the files are downloaded, go to your downloads folder and open up the folder you just downloaded. Should be titled “Tiled2Unity-master”. Open the next folder titled “unity”. You now should see a folder titled “Tiled2Unity”. You need to drag this folder into your Unity project into your assets folder that should already be re-created for you.

9) Now you can go back to the Tiled2Unity software you opened up earlier through your terminal window. Here you need to select File and then Open Tiled File… of course select your tile map you’ve created in Tiled. Next you need to set the Export To field to export to your unity project folder. Not the assets folder, just the main folder of your project. Before clicking “Big Ass Export Button” be sure you set your vertex scale appropriately. Setting this to 0.01 seems to work perfect for 32 pixel sized tiles. After you set the number press the “Big Ass Export Button” and it should say Successfully exported. Open up your Unity project and check the prefabs folder. Your map should be right there waiting for you.

Hope this helped.

-Jesse A.-

madeleine September 13, 2015 at 2:59 pm


i’ve tried installing mono and moving the unity tools and exe to my home folder, but when i type ‘mono Tiled2Unity.exe’ into terminal, i get the error:

-bash: mono: command not found

any ideas to fix?


Jeffrey Neo October 1, 2015 at 10:41 pm

For those who cannot use “mono” command in Terminal, this could be a reference:

Or you can try open “Tiled2Unity.unitypackage” to import directly, which can be found in “Tiled2Unity-master/tool/Tiled2Unity/src/bin/Debug” (downloaded from https://github.com/Gnumaru/Tiled2Unity)

J Bryan December 6, 2015 at 2:54 pm

Running OSX 10.11

Followed Jesse A’s directions. Tiled2Unity opens, but when trying to open a tmx the program crashes.

Seanba December 31, 2015 at 7:36 pm

Everyone: Tiled2Unity is now officially supported on Mac OSX and Linux through Tiled2UnityLite.


Leave a Comment

Previous post:

Next post: