Installation:

Python < 3.0. (Build platform used 2.7.3)

You may need to install the following python packages:

    bisect
    calendar
    codecs
    colorsys
    copy
    cPickle
    csv
    dateutil
    uuid
    yaml

Mercurial (http://mercurial.selenic.com/)

    *** Optional but strongly recommended! ***

    install and add '.hgrc' to your home directory with at least the
    following contents:

    ------------
    [ui]
    username = Your Name <your email address>
    ------------

    Mercurial is used to keep a record of changes to your etm data
    files.

Qt (http://qt-project.org/downloads - build platform used 4.8.3)

    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.

    Binaries are available for windows and osx.


SIP and PyQt4 (http://www.riverbankcomputing.com/software/pyqt/download -
    build platform used SIP 4.14.2 and PyQt4 4.9.5)

    *** Install Qt, then SIP and finally PyQt4 ***

    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 run.

etm

    Unpack the 'etm-x.x.x.tar.gz' tarball, cd to the resulting directory
    and do the normal

        sudo python setup.py install

    to do a system installation. You can then run

        $ etm_qt.py

    from any directory to open the etm gui.  Alternatively, you can
    just run

        $ python etm_qt.py

    from this directory to open the etm gui without doing a system
    installation.

    PREVIOUS ETM USERS:

        Before you run etm the first time, MAKE A COPY OF THE ENTIRE
        DIRECTORY

            ~/.etm

        just to be safe since the first time you run etm, it will
        create, if necessary

            ~/.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, this is the directory
        specified by 'etmdata' in ~/.etm/etmrc, and place it in

            ~/.etm/data

        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 '-m' appended:

            $ 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.

    NEW ETM USERS:

        You can download the file 'sample_datafile.txt' and place it
        in your datadir, '~/.etm/data', to have some existing items when
        you start etm.

    Now, if you have done the system installation, you can run

        $ etm_qt.py

    from any directory to open the gui, or you can just execute

        $ python etm_qt.py

    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.