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.

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

*Note*: Although the EasyMercurial distribution is a three-way universal binary for OS/X 10.4 and newer, 10.4 users will need to build their own Mercurial from source since recent enough 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.