manage events and tasks using simple text files

etm is an acronym for event and task manager.

In contrast to most calendar/todo applications, creating items (events, tasks, and so forth) in etm does not require filling out fields in a form. Instead, items are created as free-form text entries using a simple, intuitive format and stored in plain text files.

This source code for this project is available at GitHub and the documenation is available at GitHub wiki.

[ICO]NameLast modifiedSizeDescription

[DIR]Parent Directory  -  
[TXT]CHANGES18-Jan-2015 12:06 273  
[TXT]LearningtoUseRegularExpressions.html06-Feb-2010 13:59 46K 
[TXT]UserManual.html09-Sep-2014 09:56 115K 
[   ]UserManual.pdf09-Sep-2014 09:56 311K 
[   ]cheatsheet.pdf13-Jun-2014 15:12 93K 
[VID]etm-Introduction.mov07-Jun-2014 15:21 17M 
[   ]etmtk-3.0.42.tar.gz10-Nov-2014 07:01 326K 
[   ]etmtk-3.0.42.zip10-Nov-2014 07:00 333K 
[   ]etmtk-3.0.43.tar.gz18-Jan-2015 12:13 326K 
[   ]etmtk-3.0.43.zip18-Jan-2015 12:06 333K 
[DIR]images/18-Jan-2015 12:12 -  
[IMG]monthly.gif09-Sep-2014 13:34 16K 
[IMG]monthly.png09-Sep-2014 13:32 33K 
[TXT]version.txt18-Jan-2015 12:06 35  

Screen shots

Sample entries

Items in etm begin with a type character such as an asterisk (event) and continue on one or more lines either until the end of the file is reached or another line is found that begins with a type character. The beginning type character for each item is followed by the item summary and then, perhaps, by one or more @key value pairs. The order in which such pairs are entered does not matter.


Source installation under OS X, Linux or Windows

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:

Tk and the python module tkinter are also required but are typically already installed on most modern operating systems. If needed, installation instructions are given at

Installing etm

Download 'etmtk-x.x.x.tar.gz' from this site, unpack the tarball, cd to the resulting directory and do the normal

sudo python install

for a system installation. You can then run from any directory either

$ etm ?

for information about command line usage or

$ etm

to open the etm gui.

Alternatively, you can avoid doing a system installation and simply run either

$ python etm ?


$ python etm


$ ./etm

from this directory.

Installing Git or Mercurial

Having one of these version control systems is optional but strongly recommended!

With either progam installed, etm will automatically commit any change made to any data file. You can see the history of your changes either to a specific file or to any file from the GUI and, of course, you have the entire range of possibilities for showing changes, restoring previous versions and so forth from the command line.


Download Git from

Install git and then in a terminal enter your personal information

$ git config --global "John Doe"
$ git config --global

the editor you would like to use

$ git config --global core.editor vim

and the diff program

$ git config --global merge.tool vimdiff

Usage information can be obtained in several ways from the terminal

$ git help <verb>
$ git <verb> --help
$ man git-<verb>

Finally, Pro Git by Scott Chacon is available to read or download at:

If you have been using Mercurial and would like to give Git a try, you can import your etm Mercurial records into Git as follows:

$ cd
$ git clone git://
$ git init new_temp_repo
$ cd new_temp_repo
$ ~/fast-export/ -r /path/to/etm/datadir
$ git checkout HEAD

If an "unnamed head" error is reported, try adding --force to the end of the fast-export line.

At this point, you should have a copy of your etm datadir in new_temp_repo along with a directory, .git, that you can copy to the root of your etm datadir where it will join its Mercurial counterpart, .hg. You can then delete new_temp_repo.

You can now open etmtk.cfg for editing and change the setting for vcs_system to

vcs_system: git


Download Mercurial from

install it and then create the file ~/.hgrc, if it doesn't already exist, with at least the following two lines:

username = Your Name <your email address>

New etm users

By default, etm will use the directory


The first time you run etm it will create, if necessary, the following:


If the data directory needs to be created, then the following structure will be added:


The files sample.txt and holidays.txt contain illustrative data entries and the *.cfg files contain illustrative configuration entries.

The following entry will also be inserted in etmtk.cfg:

    - - personal
      - true
      - personal
    - - sample
      - true
      - sample
    - - shared
      - true
      - shared

to illustrate the use of calendars.

Previous etm users

The first time you run etm, it will copy your current configuration settings from ~/.etm/etm.cfg to ~/.etm/etmtk.cfg. You can make any changes you like to the latter file without affecting the former.

You can switch back and forth between etm_qt and etm. Any changes made to your data files by either one will be compatible with the other one.


Please share your ideas in the discussion group at GoogleGroups.

Version numbers

etm's version numbering uses the major.minor.patch format where each of the three components is an integer:

When the major version number is incremented, both the minor version number and patch number are reset to zero. Similarly, when the minor version number is incremented, the patch number is reset to zero. All increments are by one.


Copyright (c) 2009-2014 . All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.