man wyrdrc (Formats) - wyrdrc is the configuration textfile for the wyrd(1) console calendar application.

NAME

wyrdrc is the configuration textfile for the wyrd(1) console calendar application.

INTRODUCTION

CAUTION: while this manpage should be suitable as a quick reference, it may be subject to miscellaneous shortcomings in typesetting. The definitive documentation is the user manual provided with Wyrd in PDF format.

Wyrd reads a run-configuration textfile (generally /etc/wyrdrc or /usr/local/etc/wyrdrc) to determine key bindings, color schemes, and many other settings. You can create a personalized configuration file in $HOME/.wyrdrc, and select settings that match your usage patterns. The recommended procedure is to ``include'' the wyrdrc file provided with Wyrd (see INCLUDING OTHER RCFILES), and add or remove settings as desired.

WYRDRC SYNTAX

You may notice that the wyrdrc syntax is similar to the syntax used in the configuration file for the Mutt email client (muttrc).

Within the wyrdrc file, strings should be enclosed in double quotes ("). A double quote character inside a string may be represented by \" . The backslash character must be represented by doubling it (\\).

INCLUDING OTHER RCFILES

Syntax: include filename_string



This syntax can be used to include one run-configuration file within another. This command could be used to load the default wyrdrc file (probably found in /etc/wyrdrc or /usr/local/etc/wyrdrc) within your personalized rcfile, ~/.wyrdrc . The filename string should be enclosed in quotes.

SETTING CONFIGURATION VARIABLES

Syntax: set variable=value_string



A number of configuration variables can be set using this syntax; check the CONFIGURATION VARIABLES description to see a list. The variables are unquoted, but the values should be quoted strings.

CREATING KEY BINDINGS

Syntax: bind key_identifier operation



This command will bind a keypress to execute a calendar operation. The various operations, which should not be enclosed in quotes, may be found in the section on CALENDAR OPERATIONS. Key identifiers may be specified by strings that represent a single keypress, for example "m" (quotes included). The key may be prefixed with "\\C" or "\\M" to represent Control or Meta (Alt) modifiers, respectively; note that the backslash must be doubled. A number of special keys lack single-character representations, so the following strings may be used to represent them:

*
"<esc>"
*
"<tab>"
*
"<enter>"
*
"<return>"
*
"<insert>"
*
"<home>"
*
"<end>"
*
"<pageup>"
*
"<pagedown>"
*
"<space>"
*
"<left>"
*
"<right>"
*
"<up>"
*
"<down>"
*
"<f1>" to "<f12>"

Due to differences between various terminal emulators, this key identifier syntax may not be adequate to describe every keypress. As a workaround, Wyrd will also accept key identifiers in octal notation. As an example, you could use \024 (do not enclose it in quotes) to represent Ctrl-T.

Multiple keys may be bound to the same operation, if desired.

REMOVING KEY BINDINGS

Syntax: unbind key_identifier



This command will remove all bindings associated with the key identifier. The key identifiers should be defined using the syntax described in the previous section.

SETTING THE COLOR SCHEME

Syntax: color object foreground background



This command will apply the specified foreground and background colors to the appropriate object. A list of colorable objects is provided in the section on COLORABLE OBJECTS. Wyrd will recognize the following color keywords: black, red, green, yellow, blue, magenta, cyan, white.

CONFIGURATION VARIABLES

The following configuration variables may be set as described in the SETTING CONFIGURATION VARIABLES section.

*
remind_command

Determines the command used to execute Remind.
*
reminders_file

Controls which Remind file Wyrd will operate on. The default is ~/.reminders .
*
edit_old_command

Controls the command used to edit a pre-existing reminder. The special characters '%f' and '%n' will be substituted with a filename to edit and a line number to navigate to within that file.
*
edit_new_command

Controls the command used to edit a new reminder. The special character '%f' will be substituted with a filename to edit. Ideally, this command should move the cursor to the last line of the file, where the new reminder template is created.
*
edit_any_command

Controls the command used for editing a reminder file without selecting any particular reminder. The special character '%f' will be substituted with a filename to edit.
*
timed_template

Controls the format of the REM line created when editing a new timed reminder. The following character substitutions will be made: '%M' - month name, '%d' - day of the month, '%y' - year, '%h' - hour, '%m' - minute, '%w' - weekday name.
*
untimed_template

Controls the format of the REM line created when editing a new untimed reminder. The substitution syntax is the same as for timed_template.
*
templateN

Controls the format of a generic user-defined REM line template; N may range from 0 to 9. The substitution syntax is the same as for timed_template.
*
busy_algorithm

An integer value specifying which algorithm to use for measuring how busy the user is on a particular day. If busy_algorithm="1", then Wyrd will simply count the total number of reminders triggered on that day. If busy_algorithm="2", then Wyrd will count the number of hours of reminders that fall on that day. (Untimed reminders are assumed to occupy untimed_duration minutes.)
*
untimed_duration

An integer value that specifies the assumed duration of an untimed reminder, in minutes. This is used only when computing the busy level with busy_algorithm="2".
*
busy_level1

An integer value specifying the maximum number of reminders in a day (with busy_algorithm="1") or maximum hours of reminders in a day (with busy_algorithm="2") which will be colored using the color scheme for calendar_level1.
*
busy_level2

Same as above, using the calendar_level2 color scheme.
*
busy_level3

Same as above, using the calendar_level2 color scheme rendered in bold.
*
busy_level4

Same as above, using the calendar_level3 color scheme. Any day with more reminders than this will be rendered using the calendar_level3 color scheme rendered in bold.
*
week_starts_monday

A boolean value ("true" or "false") that determines the first day of the week.
*
schedule_12_hour

A boolean value that determines whether the timed reminders window is drawn using 12- or 24-hour time.
*
selection_12_hour

A boolean value that determines whether the selection information is drawn with 12- or 24-hour time.
*
status_12_hour

A boolean value that determines whether the current time is drawn using a 12- or 24-hour clock.
*
description_12_hour

A boolean value that determines whether reminder start and end times are drawn using 12- or 24-hour time in the description window. This value also controls the format of timestamps in the formatted calendars produced by view_week and view_month.
*
center_cursor

A boolean value that determines how the screen and cursor move during scrolling operations. When set to "true", the cursor is fixed in the center of the timed reminders window, and the schedule scrolls around it. When set to "false" (the default), the cursor will move up and down the schedule during scrolling operations.

For maximum usefulness, busy_level1 < busy_level2 < busy_level3 < busy_level4.

CALENDAR OPERATIONS

Every Wyrd operation can be made available to the interface using the syntax described in the section on CREATING KEY BINDINGS. The following is a list of every available operation.

*
scroll_up

move the cursor up one element
*
scroll_down

move the cursor down one element
*
next_day

jump ahead one day
*
previous_day

jump backward one day
*
next_week

jump ahead one week
*
previous_week

jump backward one week
*
next_month

jump ahead one month
*
previous_month

jump backward one month
*
home

jump to the current date and time
*
zoom

zoom in on the day schedule view (this operation is cyclic)
*
edit

edit the selected reminder
*
edit_any

edit a reminder file, without selecting any particular reminder
*
scroll_description_up

scroll the description window contents up (when possible)
*
scroll_description_down

scroll the description window contents down (when possible)
*
new_timed

create a new timed reminder
*
new_timed_dialog

same as previous, with a reminder file selection dialog
*
new_untimed

create a new untimed reminder
*
new_untimed_dialog

same as previous, with a reminder file selection dialog
*
new_templateN

create a new user-defined reminder using templateN, where N may range from 0 to 9
*
new_templateN_dialog

same as previous, with a reminder file selection dialog
*
switch_window

switch between the day schedule window on the left, and the untimed reminder window on the right
*
begin_search

begin entering a search string
*
search_next

search for the next occurrence of the search string
*
next_reminder

jump to the next reminder
*
view_remind

view the output of remind for the selected date
*
view_remind_all

view the output of remind for the selected date, triggering all non-expired reminders
*
view_week

view Remind's formatted calendar for the week that contains the selected date (the in-calendar timestamp formats are determined by the value of description_12_hour)
*
view_month

view Remind's formatted calendar for the month that contains the selected date (the in-calendar timestamp formats are determined by the value of description_12_hour)
*
refresh

refresh the display
*
quit

exit Wyrd
*
entry_complete

signal completion of search string entry
*
entry_backspace

delete the last character of the search string
*
entry_cancel

cancel entry of a search string

COLORABLE OBJECTS

Each of Wyrd's on-screen elements may be colored by the color scheme of your choice, using the syntax defined in the section on SETTING THE COLOR SCHEME. The following is a list of all colorable objects.

*
help

the help bar at the top of the screen
*
timed_default

an empty timeslot in the day-schedule window
*
timed_current

the current time in the day-schedule window (if it is visible)
*
timed_reminder1

a nonempty timeslot in the day-schedule window, indented to level 1
*
timed_reminder2

a nonempty timeslot in the day-schedule window, indented to level 2
*
timed_reminder3

a nonempty timeslot in the day-schedule window, indented to level 3
*
timed_reminder4

a nonempty timeslot in the day-schedule window, indented to level 4
*
untimed_reminder

an entry in the untimed reminders window
*
timed_date

the vertical date strip at the left side of the screen
*
selection_info

the line providing date/time for the current selection
*
description

the reminder description window
*
status

the bottom bar providing current date and time
*
calendar_labels

the month and weekday labels in the calendar window
*
calendar_level1

calendar days with low activity
*
calendar_level2

calendar days with medium activity
*
calendar_level3

calendar days with high activity
*
calendar_today

the current day in the calendar window (if it is visible)
*
calendar_selection

the selected day in the calendar window
*
left_divider

the vertical line to the left of the timed reminders window
*
right_divider

the vertical and horizontal lines to the right of the timed reminders window

CONTACT INFO

Wyrd author: Paul Pelzl <pelzlpj@eecs.umich.edu>

Wyrd website: http://www.eecs.umich.edu/~pelzlpj/wyrd

MISCELLANEOUS

``Wyrd is a concept in ancient Anglo-saxon and Nordic cultures roughly corresponding to fate.'' -- Wikipedia

SEE ALSO

AUTHOR

This manpage is written by Paul J. Pelzl <pelzlpj@eecs.umich.edu>.