Before attemping to use Wyrd, learn how to use Remind. Wyrd makes no attempt to hide the details of Remind programming from the user.

At the top of the window is a short (incomplete) list of keybindings.

The left window displays a scrollable timetable view, with reminders highlighted in various colors. If the DURATION specifier is used for a reminder, the highlighted area is rendered with an appropriate size. Overlapping reminders are rendered using one of four different indentation levels so that all reminders are at least partially visible. If the current time is visible in this window, it is highlighted in red.

The upper right window displays a month calendar, with the color of each day representing the number of reminders it contains. The colors range across shades of white to blue to magenta as the number of reminders increases. The selected date is highlighted in cyan; if the current date is visible, it is highlighted in red.

The lower right window displays a list of the untimed reminders falling on the selected date.

The bottom window displays the full text of the MSG for the reminder or reminders that are currently selected.

l l . _ Action Keypress _ scroll up and down the schedule <up>, <down> or k, j jump back or forward by a day <pageup>, <pagedown> or 4, 6 or <, > or H, L jump back or forward by a week 8, 2 or [, ] or K, J jump back or forward by a month {, } jump to current date and time <home> jump to the next reminder <tab> switch between schedule and untimed reminders window <left>, <right> or h, l zoom in on the schedule z scroll the description window up and down d, D _

Notice that if you have a numeric keypad, the {4, 6, 8, 2} keys will let you move directionally in the month calendar view at the upper-right of the screen. Similarly, {H, J, K, L} will cause directional calendar movement using the standard mapping from vi(1).

Note: By default, Wyrd is configured to use the Vim editor for modifying your reminder files. To use a different editor, see the wyrdrc(5) manpage.

If you select a timeslot in the schedule view, then hit 't', you will begin creating a new timed reminder. Wyrd will open up your reminder file in your favorite editor and move the cursor to the end of the file, where a new reminder template has been created. The template has the selected date and time filled in, so in many cases you will only need to fill in a MSG value.

Similarly, hitting 'u' will begin creating an untimed reminder. 'w' will create a weekly timed reminder, and 'W' will create a weekly untimed reminder; 'm' will create a monthly timed reminder, and 'M' will create a monthly untimed reminder.

'T' and 'U' also create timed and untimed reminders (respectively), but first will provide a selection dialog for you to choose which reminder file you want to add this reminder to. The set of reminder files is determined by scanning the INCLUDE lines in your default reminder file.

If you select a reminder (either timed or untimed) and hit <return>, you will begin editing that reminder. Wyrd will open up the appropriate reminders file in your editor and move the cursor to the appropriate REM line.

If you select a timeslot that contains multiple overlapping reminders, Wyrd will provide a dialog that allows you to select the desired reminder.

If you hit <enter> on a blank timeslot, Wyrd will begin creating a new timed or untimed reminder (depending on whether the timed or the untimed window is selected).

Finally, pressing 'e' will open the reminder file in your editor without attempting to select any particular reminder.

Aside from viewing reminders as they fall in the schedule, you can press 'r' to view all reminders triggered on the selected date in a less(1) window. Similarly, 'R' will view all reminders triggered on or after the selected date (all non-expired reminders are triggered).

If you want to get a more global view of your schedule, Wyrd will also let you view Remind's formatted calendar output in a less(1) window. Pressing 'c' will view a one-week calendar that contains the selected date, while pressing 'C' will view a one-month calendar containing the selected date.

Wyrd allows you to search for reminders with MSG values that match a search string. Press '/' to start entering a (case insensitive) regular expression. After the expression has been entered, press <return> and Wyrd will locate the next reminder that matches the regexp. Press 'n' to repeat the same search. Entry of a search string may be cancelled with <esc>.

The regular expression syntax is Emacs-compatible.

Note: Sorry, there is no "search backward" function. The search function requires the use of "remind -n", which operates only forward in time. For the same reason, there is a command to jump forward to the next reminder, but no command to jump backward to the previous reminder.

A list of all keybindings may be viewed by pressing '?'. You can exit Wyrd by pressing 'Q'. If the screen is corrupted for some reason, hit 'Ctrl-L' to refresh the display.

You may wish to generate some sort of alarm when a reminder is triggered. Wyrd does not offer any special alarm functionality, because Remind can handle the job already. Check the Remind manpage and consider how the -k option could be used to generate alarms with the aid of external programs. For example, the following command will generate a popup window using gxmessage(1) whenever a timed reminder is triggered:

remind -z -k'gxmessage -title "reminder"  &' ~/.reminders &

   REM Nov 27 2005 AT 14:30 +15 MSG Do something

Alternatively, if you want to generate alarms only for specific reminders, consider using Remind's RUN command. This process could be easily automated by using the templateN configuration variables described in the wyrdrc(5) manpage.

Remind's TAG specifier may be used to cause Wyrd to give special treatment to certain reminders. If a reminder line includes the clause "TAG noweight", then Wyrd will not give that reminder any weight when determining the ``busy level'' colorations applied to the month calendar. If a reminder line includes the clause "TAG nodisplay", then Wyrd will neither display that reminder nor give it any weight when determining the month calendar colorations. The tag parameters are case insensitive.

WARNING: These tag parameters are not guaranteed to interact well with other Remind front-ends such as tkremind.