How To: run Git Extensions on Linux

Tested on:

• Ubuntu 16.04
• Mono 4.6.1
• Git 2.7.4
• KDiff3 0.9.98
• GitExtensions 2.49RC2

Installation

1. Install git: sudo apt install git
   check git: git --version
   

2. Install mergetool kdiff3: sudo apt install kdiff3
   check Kdiff3: kdiff3 --version
   

3. Install Mono to run GitExtensions. Version should be 5.14 or above)
   Add repository to install the latest version of Mono
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
sudo apt update
   install: sudo apt install mono-complete
   check: mono --version
   

4. Install GitExtensions
   Download GitExtensions-2.51.05-Mono.zip from GitExtensions v2.51.05 release for Linux.
   Unzip to any folder

5. ❗ Delete .\Plugins\BitBucket.dll

6. Start GitExtensions
   Open GitExtensions folder and double click GitExtensions.exe
   If error occurred, then open terminal and execute the following command. sh gitext.sh when you first start you will see a language selection
   

7. Configuring GitExtensions
   
   1. and 2. Your name and email
   3. Editor default GitExtensions
   4. kdiff3
   5. /usr/bin/kdiff3
   7. and 8. as 4. and 5.
   9. Whatever you prefer
   10. Unicode (UTF-8)
   

DONE

Building

The Windows page may have more information: see Build Instructions with Mono

Building the installer

• Run \Setup\BuildInstallers.Mono.cmd

How to build and test in Mono

Mono 4.4.0 or later is required, because it uses C# 4.6.1 compiler by default. Refer to Git Extensions on Linux for details on how to build and debug on Linux.

Images and Linux compatibility

Not all image formats are supported on Mono. PNG images with a color depth of 48 bpp will cause compiler errors. If you run into this problem you should convert all PNG images to 8 bpp.

This can be done using the following Linux commands:

sudo apt-get install imagemagick
mogrify -depth 8 $(find -iname '*.png')
mogrify -depth 8 $(find -iname '*.PNG')

Running tests

Tests use NUnit under Mono.

Download prebuilt package

• openSUSE: http://software.opensuse.org/package/GitExtensions
  • which is currently fed by https://build.opensuse.org/package/show/home:codeminister/GitExtensions.

macOS/Mono

macOS Mono support for Git Extensions is unknown.

Note specifically though that you at least in 5.4 must run tMono in 32bit version as the 64bit WinForm support is incomplete. Start with --arch=32. http://www.mono-project.com/docs/about-mono/supported-platforms/osx/