Tangra 3 - Installation Notes



Tangra 3 is developed using the C++ and C# languages. On Linux and OS X it uses the open source Mono Platform to run the C# .NET Framework code. On Windows the C# code runs natively using the Microsoft .NET Framework that comes with Windows.


Installing and Running Tangra 3 on Windows

1) Tangra will run on Windows XP SP2, Windows Vista, Windows 7 and possibly Windows 8 (hasn't been tested yet)

2) Make sure that your Windows box is up to date with Windows Updates. If you are in doubt make sure that you have .NET Framework 4.0 installed:

  • Microsoft .NET Framework 4 Client Profile (Standalone Installer)


  • 3) Download the latest version of Tangra 3 for Windows. Unzip all files in a location of your choice.

    4) Double-click Tangra.exe to run the software.


    Installing and Running Tangra 3 on Linux

    1) Tangra will run on Ubuntu, Debian, openSUSE as well as other versions of Linux supported by the Mono Framework.

    2) Install the latest stable version of Mono for your version of Linux from the Mono web site (must be newer than 2.10.x):

  • http://www.go-mono.com/mono-downloads/download.html


  • For Debian/Ubuntu distributions you will need to install the "mono-complete" package. Follow the instrunctions on the Mono Web Site.
    Use the commands below to install Mono on the supported Long Term Support distributions of Ubuntu (12, 14, 16):

    Ubuntu 16.04 LTS & 14.04 LTS

    path$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
    path$ echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
    path$ sudo apt-get update
    path$ sudo apt-get install mono-complete

    Ubuntu 12.04 LTS

    path$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
    path$ echo "deb http://download.mono-project.com/repo/debian wheezy-libtiff-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list
    path$ sudo apt-get update
    path$ sudo apt-get install mono-complete

    Ubuntu 10.04 LTS

    path$ sudo apt-get install mono-complete

    3) Download the latest version of Tangra 3 for your distribution of Linux. Unzip all files in a location of your choice.

    4) Open up a Terminal session and navigate to the location where you extracted Tangra's files. Then type the following to start Tangra:

    path$ ./Tangra

    NOTE: To see complete log of Mono running Tangra, for example to troubleshoot startup problems use the following command:

    path$ MONO_LOG_LEVEL=debug LD_LIBRARY_PATH="." mono Tangra.exe


    Installing and Running Tangra 3 on Mac OSX

    1) Tangra will run on Mac OSX Leopard (10.5), Mac OSX Snow Leopard (10.6), and Mac OSX Lion (10.7) but requires X11 so make sure your OSX is up to date and has X11 installed.

    2) Install Mono 2.10.9 Runtime for Mac OSX from the Mono web site or from the direct link below:

  • MonoFramework-MRE-2.10.9_10.macos10.xamarin.x86.dmg


  • NOTE: There is currently a problem with fonts with Mono 3.0.x and Mono 2.10.10 on Mac OSX so version 2.10.9 is required for Tangra to run.

    3) Download the latest version of Tangra 3 for Mac OSX. Unzip all files in a location of your choice.

    4) Open up a Terminal session and navigate to the location where you extracted Tangra's files. Then type the following to start Tangra:

    username$ DYLD_LIBRARY_PATH="." mono Tangra.exe


    NOTE: Running Tangra via the Terminal is a temporary solution for the Beta version. It is expected that the final release will be started like the standard applications for Mac.