Options

-a

Issue reminders for both standard and periodic actions. This is the default if no options, or message, are specified.

-c f,b f,b f,b f,b

Sets the urgency colour pairs for colour highlighting. There are four urgency levels, 1, the highest, to 4, the lowest. Each urgency is assigned a foreground and background colour (the default being white on black). All four colour pairs must be specified if the -c argument is given. Colour pair codes are as defined by ANSI Select Graphic Rendition subset. The -c argument may be specified with any invokation of remind, e.g. during remind.db file initialisation or reporting.

-D n[,n ...]

Deletes an action or actions, identified by their action numbers. Each action is given a unique number which must be specified in order to delete an action. If the -q switch is specified, the contents of the action are nulled.

-d DATE

Sets the date for an action. A DATE must be in the form dd/mm[/yyyy].

-e

Writes, on stdout, the remind commands necessary to build the remind file. Output may be re-directed to a file.

-f FILENAME

Sets remind database file name. The default is remind.db

-h

Highlight actions, based on -u (urgency) and -c (colour) settings. Highlighting uses ANSI escape sequences and colours. If omitted, no highlighting is performed.

-i

Initialises the remind.db file. If the remind.db file already exists, you will be asked to confirm initialisation. (The -q switch will cause this confirmation question to be omitted).

-L

As -l (see below), but also displays the contents of the remind.db file header record, and all records that are on the free list.

-l

Lists the contents of the remind.db file. The report is not urgency highlighted, and reports on the entire contents of the file (i.e. dates, warnings, urgencies, timeouts etc). The -s or -p options may be specified and will restrict the report to standard or periodic actions respectively.

-m n[,n ...]

Modifies the action(s) identifed by n. The urgency, warning, timeout, date, repeat and message may be modifed. The new values should be specified by using the appropriate argument (and/or a message).

-P POINTER

Changes the next_action pointer in an action to the integer value POINTER. The action record to modify is selected by the -m argument. CAUTION: Misuse can seriously damage the remind.db file.

-p

Reports on periodic actions only. If a message is present, forces definition of a periodic action.

-q

Causes remind to omit the message confirming the creation of an action. Suppresses background actions message when reporting standard actions. Also suppresses confirmation question when creating a remind file and the file already exists. Lastly, when deleting an action, will cause the action contents to be nulled.

-r REPEAT

Sets the type of repetition for a periodic action. The REPEAT argument must take one of the following forms:

y

yearly (the default).

m

monthly, based on the day of the action date.

wN[,M]

Nth weekday (0 is Sunday, 6 is Saturday) of every Mth week. If M is omitted, default is 1. This repeat will cause the date of the action to be adjusted to match N.

nN[,M]

Mth occurrence of the Nth weekday in a month. If the Mth occurrence value is 5 or more, the due date will be the last occurrence of the Nth weekday in the month. If M is omitted, default is 1.

-s

Reports on standard actions only. If specified when defining a new action, this flag will force a standard action definition, even if a date is given. This allows the creation of delayed standard actions.

-t TIMEOUT

Sets the timeout for an action. The timeout value is in days. remind will automatically delete an action TIMEOUT days after its defined date.

-u URGENCY

This argument serves two purposes. Firstly, it sets the urgency when defining an action. Valid urgency values are zero to 4, inclusive. An action with zero urgency is known as a background action and will not normally be reported, although the number of background actions that have been defined will be issued. The default urgency is 4. Secondly, when the -u argument is specified for reporting, only actions of that urgency are reported. Zero is a valid urgency, and is the only time the background actions will be displayed.

-v

Print version number.

-w WARNING

Sets the number of days warning required for a periodic action. Default is 7 days.

-X n[,n ...]

Prints the contents of the action(s) specified by n. The output includes the next_action pointer.

-z

Toggles the current snooze state of the periodic reminders specified via the -m argument. Snoozed reminders will not be issued until their next event time. Specifying the -z argument for a periodic action that is currently snoozed will unsnooze the action.

message

Sets the message to be issued for the action. Multiple spaces between words will be reduced to one. If the first word in a message is in the date format (dd/mm[/yyyy]), a periodic action will be defined. During modification, if the message contains an ampersand (&), the existing message will be used in place of the ampersand. This permits the easy addition of leading and/or trailing text to an existing message. The message is limited to 80 characters and must follow all other arguments.