EasyMercurial

h1. Installing EasyMercurial

h2. Windows

Download the latest EasyMercurial installer release from the "download page":/projects/easyhg/files.

The current release is always highlighted in bold on that page.  You just need the file whose name ends in @Setup.exe@.

The installer includes the Mercurial executable and the KDiff3 diff/merge application (thanks to bundling mechanisms from the TortoiseHg project).  Just install and run.

h2. Mac OS/X

Download the current EasyMercurial @.dmg@ file from the "download page":/projects/easyhg/files.

The current release is always highlighted in bold on that page.  You just need the file whose name ends in @dmg@.  It's a three-way universal binary (PPC/i386/x86_64) for OS/X 10.4 and newer.

The OS/X release includes the KDiff3 diff/merge application, but does not include Mercurial itself.  You will need to "download that":http://mercurial.selenic.com/ separately; the standard installer for Mercurial 1.7 or newer should be fine.

Unfortunately OS/X 10.4 users will need to build their own Mercurial from source, since recent versions are no longer distributed for that platform.

h2. Linux

A 32-bit Linux binary is available which will run on most current Linux distributions -- including 64-bit ones with a suitable compatibility layer.  Proper distribution packages are still pending.

First install the prerequisites using your distribution's package manager.  These are Mercurial itself, the Qt4 and PyQt4 toolkits, and KDiff3.  In Ubuntu the packages you need are: @mercurial@ @libqtgui4@ @python-qt4@ @kdiff3@.

Then download the current EasyMercurial Linux binary @.tar.gz@ file from the "download page":/projects/easyhg/files.

The current release is always highlighted in bold on that page.  You just need the file whose name ends in @linux-i386.tar.gz@.

Unpack that file into a suitable place, and run the @EasyMercurial@ program from it.