There is an installable, 64bit application. Download etm_qt-x.x.x.dmg from this site, open it and drag etm.app to your Applications folder. If you already have etm.app in your Applications folder, then you might want to rename the new version to something like etm_qt.app before moving it to Applications. Follow the instructions below to install Mercurial.
Since pyinstaller has not yet been ported to python 3, this application is built with python 2.7.3.
Python 2.7.x or python >= 3.3.0 is required.
The following python packages are required for etm but are not included in the python standard library:
Windows users can skip this step and proceed to SIP and PyQt. The binary PyQt installer for Windows installs Qt, SIP and PyQt in one step.
http://qt-project.org/downloads - the build platform used 4.8.4.
You may not need to install Qt. Qt is a part of the standard package installation for Ubuntu 12 and possibly other linux distributions as well. Both Qt 4 and Qt 5 are supported.
Binaries are available for windows and osx.
Both SIP and PyQt are available from
As noted above the binary installer for Windows installs compatible versions of Qt, SIP and PyQt in one step.
The following combinations have been tested:
python 2.7.3 or 2.7.5: Qt 4.8.4, SIP 4.14.1-2 and PyQt4 4.9.5
python 3.3.0 or 3.3.2: Qt 4.8.4, SIP 4.14.1-3 and PyQt 4.9.6 or 4.10
python 2.7.6 or 3.3.3: Qt 4.8.5, SIP 4.15.3 and PyQt 4.10.3
python 2.7.6 or 3.3.3: Qt 5.1.1, SIP 4.15.3 and PyQt 5.1.1
Install Qt, then SIP and finally PyQt
Windows users can skip this step.
For both SIP and PyQt, use the standard python installation process:
python configure.py make sudo make install
Note: You will get either a 32bit or 64bit installation depending upon the version of python you use with
configure.py. For example, you would use
for both SIP and PyQt to get python 3 versions.
You will need setuptools to use any of the etm installation options below. Downloads and instructions are available at:
Installing setuptools makes easy_install available and you can use it to install pip
sudo easy_install pip
sudo pip install -U etm_qt
For an initial install,
-U can be omitted. Note that use of the latest version of pip might require replacing "pip" with, e.g., "pip2", "pip-2.7" or "pip-3.3".
sudo easy_install -U etm_qt
For an initial install,
-U can be omitted.
Download 'etm_qt-x.x.x.tar.gz' from this site, unpack the tarball, cd to the resulting directory and do the normal
sudo python setup.py install
for a system installation. You can then run from any directory either
$ etm_qt ?
for information about command line usage or
to open the etm gui.
Alternatively, you can avoid doing a system installation and simply run either
$ python etm_qt ?
$ python etm_qt
from this directory.
Optional but strongly recommended!
Download Mercurial from
install it and then create the file ~/.hgrc, if it doesn't already exist, with at least the following two lines:
[ui] username = Your Name <your email address>
Mercurial is used to keep a record of changes to your etm data files.
Just to be safe, before you run etm the first time, make a copy of the entire directory:
The first time you run etm it will create, if necessary, the following:
~/.etm ~/.etm/etm.cfg ~/.etm/data
You can edit ~/.etm/etm.cfg to change the location of the data directory if you wish. You should choose a different location from your current data directory.
If you want to use your existing data files, make a copy of your current data directory (the directory specified by
etmdata in ~/.etm/etmrc) and place it in
or whatever location you specified for
datadir in ~/.etm/etm.cfg. Next download
one2two.py.txt from this site, cd to the location of
datadir and then execute
$ python pathto/one2two.py.txt
This will traverse your data directory reading **.text* files and displaying the item by item changes that the new format would entail. Run this script with
$ python pathto/one2two.py.txt -m
to actually write the items in the new format to .txt* files. Note that your existing files will not be changed. You can run this script again but it will overwrite any changes you have made to the new .txt* files.
If you follow these suggestions, your new etm installation will be completely independent of your current installation.
You can download files from the sample folder on this site. Put
sample_datafile.txt in your datadir,
~/.etm/data by default, to have some existing items when you start etm.
Now, if you have done the system installation, you can run
from any directory to open the gui, or you can just execute
$ python etm_qt
from the unpack directory to run etm without a system installation.
A good strategy is to look first at overview.html under help information on this web site and then the other help files there. This same information is available by pressing F1 in the etm gui. The file cheatsheet.pdf is intended to be a helpful reference.
As of November 2013, icalendar 3.6 has not yet been released but is available using git:
git clone https://github.com/collective/icalendar/↩