4.2. Windows Explorer Integration

4.2.1. Overlay Icons

TortoiseHg provides visual representation of the file status via overlay icons in the MS-Explorer windows. This is similar to those that found on other Tortoise client, such as TortoiseCVS and TortoiseSVN.

TortoiseHg shares the overlay icons with TortoiseSVN (version 1.5.x or later) and the other “Tortoise” projects via the use of TortoiseOverlays (another project created by TortoiseSVN team).

Overlay icons

Overlay icons in Icons view (XP)

The context menu has an Update Icons option which forces TortoiseHg to refresh the icons in the currently browsed repository or directory of repositories. The taskbar icon will turn green and the directory icons will turn into question marks while this refresh is in progress.

The overlay handler and context menus are configurable. From any folder background (even the desktop), right click and select TortoiseHg ‣ Explorer Extension Settings. In the settings dialog you can promote individual menu options to the top menu.

Shell Configuration dialog

Shell Configuration Dialog

One can selectively disable overlay icons in a specific repository by editing the .hg\thgstatus file inside the repository and replacing it’s contents with a single line containing:


4.2.2. Context Menus

TortoiseHg commands may be accessed via the context menu of Explorer windows and other applications which use the standard File/Open dialogs. Here is the context menu for a revisioned folder:

Context menu

Context menu for a folder under Mercurial revision control

And here is the context menu for selected files or folders:

Context menu

Context menu for file or folder selection

TortoiseHg provides dialogs for the most regularly used Mercurial commands. Less frequently used and newly added Mercurial commands may be accessed from the CLI (command line interface) through cmd.exe on Windows.

4.2.3. Nautilus

TortoiseHg also provides shell integration with the GNOME desktop via a nautilus-python plugin. If you have installed TortoiseHg from a distribution package, the odds are that this extension is already configured. If not, please consult our Wiki for instructions on how to enable this feature.

While the nautilus extension does not have it’s own GUI for managing the overlays and context menus, it does support command promotion into the top menu. It requires you to edit your ~/.hgrc file and add lines like these:

promoteditems = commit, log, synch
Nautilus screenshot

GNOME/Nautilus screenshot

Table Of Contents

Previous topic

4.1. Common Features

Next topic

4.3. Create a new repository

This Page