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

First *download Mercurial itself* from the "Mercurial website":http://mercurial.selenic.com/ and install that using its installer.

Then *download the current EasyMercurial @.dmg@ file* from our "download page":/projects/easyhg/files and install EasyMercurial by dragging to the Applications folder.

The current release is always highlighted in bold on that page.

*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@ @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.