TortoiseGit Manual

Installing TortoiseGit

System requirements

TortoiseGit runs on Windows Vista or higher. Windows 98, Windows ME, Windows NT4, Windows 2000 and Windows XP SP3 are no longer supported. If you are running such an old system, you can still use older, however unsupported, releases of TortoiseGit. Those can be found on the download server (TortoiseGit 1.7 dropped support for Windows 2000; TortoiseGit 1.9 dropped support for Windows XP).

If you encounter any problems during or after installing TortoiseGit please refer to Appendix A, Frequently Asked Questions (FAQ) first.

Installation

TortoiseGit comes with an easy to use installer. Double click on the installer file and follow the instructions. The installer will take care of the rest.

Important

You need Administrator privileges to install TortoiseGit.

Language Packs

The TortoiseGit user interface has been translated into many different languages, so you may be able to download a language pack to suit your needs. You can find the language packs on our translation status page . And if there is no language pack available yet, why not join the team and submit your own translation ;-)

Each language pack is packaged as a .msi installer. Just run the install program and follow the instructions. After the installation finishes, the translation will be available.

Spellchecker

TortoiseGit includes a spell checker which allows you to check your commit log messages. This is especially useful if the project language is not your native language. The spell checker uses the same dictionary files as LibreOffice , OpenOffice and Mozilla .

The installer automatically adds the US English dictionary. If you want other languages, the easiest option is simply to install one of TortoiseGit's language packs. This will install the appropriate dictionary files as well as the TortoiseGit local user interface. After the installation finishes, the translation will be available.

Or you can install the dictionaries yourself. If you have OpenOffice or Mozilla installed, you can copy those dictionaries, which are located in the installation folders for those applications. Otherwise, you need to download the required dictionary files from http://cgit.freedesktop.org/libreoffice/dictionaries/ or http://wiki.services.openoffice.org/wiki/Dictionaries

Once you have got the dictionary files, you probably need to rename them so that the filenames only have the locale chars in it. Example:

  • en_US.aff

  • en_US.dic

Then just copy them into the %APPDATA%\TortoiseGit\dic folder. If that folder isn't there, you have to create it first. TortoiseGit will also search the Languages sub-folder of the TortoiseGit installation folder (normally this will be C:\Program Files\TortoiseGit\Languages); this is the place where the language packs put their files. However, the %APPDATA%-folder doesn't require administrator privileges and, thus, has higher priority. The next time you start TortoiseGit, the spell checker will be available.

If you install multiple dictionaries, TortoiseGit uses these rules to select which one to use.

  1. Check the tgit.projectlanguage setting. This setting can be set using TortoiseGit Settings Dialogs 3 page (the section called “TortoiseGit Dialog Settings 3”). Refer to the section called “git-config(1)” for information about setting properties (use the LCID Dec value as assigned by Microsoft).

  2. If no project language is set, or that language is not installed, try the language corresponding to the Windows locale.

  3. If the exact Windows locale doesn't work, try the Base language, eg. de_CH (Swiss-German) falls back to de_DE (German).

  4. If none of the above works, then the default language is English, which is included with the standard installation.