# wxRemind

_version 0.7.5 - 2007-01-25_

wxRemind is a graphical front-end to [ Remind][1], a remarkably sophisticated calendar and alarm system. wxRemind is similar to [Wyrd][2] but is based on [wxPython][3] rather than curses. See [screenshots][4] to see a comparison of both in action. The display features a calendar and daily event list suitable for visualizing your schedule at a glance. Dates and associated events can be quickly selected either with the mouse or cursor keys, and dates in the calendar are color coded to reflect the total duration of scheduled events. wxRemind integrates with an external editor of your choice to make editing of reminder files more efficient, provides hotkeys to quickly access the most common Remind options, allows popup, sound and/or spoken alerts and can display a postscript calendar of the selected month suitable for printing.

New support for OS X for versions >= 0.7.0 and for a printable, 'next n days' view in versions >= 0.7.5. See [CHANGES][5] for details.

### Requirements

The latest version of wxRemind should be available at [wxRemind][6].

You will need to have [ remind][7], [python][8] >= 2.4.3 and [wx][9] (python) >= 2.6.1. wxRemind has been tested with python 2.5 and wx 2.8.0.1 on OS X Tiger and with python 2.4.3 and wx 2.6.1 on Fedora Core 4 (linux).

Displaying monthly postscript calendars requires rem2ps (included with remind) and Preview.app on OS X or ggv (gnome ghostview) on linux.

Audible, spoken-message alerts require a text to speech synthesis utility, e.g., 'say' on OS X or '[festival][10]' on linux.

Visible alerts are supported internally but external utilities such as OS X's 'growlnotify' are also supported.

### Installation

Unpack the contents of the wxRemind.tgz in a convenient, permanent location, open a terminal window and then at a command prompt (not as root but as yourself):

$ cd <path to wxRemind directory>

$ python INSTALL

and follow the instructions. INSTALL has two stages and, for each, detailed information about what will be done will be provided together with an opportunity to cancel - details below.

Using INSTALL has the following advantages:

  1. It doesn't require root privileges.
  2. It leaves your python tree untouched. To remove wxRemind simply delete the directory where it was unpacked and the three symbolic links created by INSTALL to wxremalert, wxremdata and wxremind.py.
  3. It runs on a wide variety of platforms without tweaking. Since the package files are in a subdirectory of the root directory where the scripts are located, the scripts can automatically find the package files ON ANY PLATFORM without further intervention.

This configuration process will check for sufficiently recent versions of 'python' and 'wxPython' and for the presence of 'remind' in your system path.

It will then create '.wxremfloat' in your home directory, overwriting any existing file. The contents of this file will make it possible for you to use floating reminders.

Next it will check for the existence of '.reminders' and '.wxremindrc' in your home directory. If '.reminders' exists it will be checked to make sure that it contains an 'include .wxremfloat' line. If it does not, first a backup will be made named '.reminders.bak' and then the appropriate line will be inserted at the beginning of the original file. If '.reminders' does not exist, then it will be created with the necessary line as its only content.

A new configuration file will then be created called '.wxremindrc' if this file does not alread exist and '.wxremindrc.new' otherwise. This file will automatically contain the correct settings for 'remind', 'reminders' and 'wxremfloat'.

Additionally, a file will be created called .wxremvars which contains a list of all the variables that must be set in .wxremindrc in the current release. This file is used at startup to confirm that the required variables have been set.

Finally, a report of messages generated during configuration will be displayed.

**IMPORTANT** If created by the configuration process, it is strongly recommended that you edit ~/.wxremindrc.new to reflect any custom settings that you may have made in your existing ~/.wxremindrc, and then save ~/.wxremindrc.new as ~/.wxremindrc. Settings in version 0.7.x of wxRemind differ somewhat from earlier versions. Otherwise, check the settings in your new ~/.wxremindrc and make any necessary changes. Instructions are included at the beginning of the file.

You can now run wxRemind by opening a terminal window and entering

$ wxremind.py &

Once wxRemind is running, pressing ? will bring up a display of usage information.

### License

Copyright (c) 2006-2007 Daniel A. Graham <[daniel.graham@duke.edu][11]& gt;

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 (www.gnu.org/licenses/gpl.html); either version 2 of the License, or (at your option) any later version. This program is provided in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. Details are provided in the included COPYING file.

   [1]: http://www.roaringpenguin.com/penguin/open_source_remind.php
   [2]: http://www.eecs.umich.edu/~pelzlpj/wyrd
   [3]: http://www.wxpython.org
   [4]: screenshots.html
   [5]: CHANGES
   [6]: http://www.duke.edu/~dgraham/wxRemind
   [7]: http://www.roaringpenguin.com/penguin/openSourceProducts/remind
   [8]: http://www.python.org/download/
   [9]: http://www.wxpython.org/
   [10]: http://www.cstr.ed.ac.uk/projects/festival
   [11]: mailto:daniel.graham@duke.edu