hgview /

Filename Size Date modified Message
49 B
2.3 KB
17.6 KB
5.7 KB
682 B
1.8 KB
24 B
14 B
14 B
13.7 KB


Its purpose is to easily navigate in a Mercurial repository history. It has been written with efficiency in mind, both in terms of computational efficiency and user experience efficiency.

It is written in Python.

There are two user interfaces:
  • a graphical intarfece using PyQt4 and QScintilla, the
  • a text interface: using urwid, pygments and pyinotify

Note that the Qt4 interface is much more complete than the text interface. The Qt4 interface provides more views on the repository.

hgview intallation notes

hgview can be used either as a hg extension, or as a standalone application.

The Common library depends on: mercurial (1.0 minimum) The Qt4 interface depends on PyQt4, QScintilla and PyQScintilla, DocUtils The Text interfaces depend on urwid (>=0.9.1 for "raw", >=1.0.0 for "curses"), pygments and pyinotify

Run from the hg repository

You can run hgview without installing it.

hg clone http://hg.logilab.org/hgview

You may want to add the following to your main .hgrc file:


# your hgview configs statements like:
interface=qt # or curses or raw
# type hg qv-config to list available options

Then from any Mercurial repository:

hg qv



Installing hgview

Installing hgview is simply done using usual distutils script:

python setup.py install --help # for available options
python setup.py install

More informations

See hg help hgview for more informations on available configuration options.


Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.