1RCLOCK(1) 2003 RCLOCK(1)
2
6 rclock (ouR CLOCK) — clock and appointment reminder for X11
7
9 rclock [options]
10
13 rclock — version 2.7.10 — is an analog clock for X intended as an
14 xclock(1) replacement that conserves memory and has extra features:
15 rclock enters reverse video if there is mail waiting; an appointment
16 reminder is also builtin.
17
20 The options supported by rclock:
21 -display displayname
23 Attempt to open a window on the named X display. In the absence
24 of this option, the display specified by the DISPLAY environment
25 variable is used.
26 -geometry geom
28 Create the window with the specified X window geometry [default
29 80x80].
30 -bg color
32 Window background color [default white].
33 -fg color
35 Window foreground color [default black].
36 -fn fontname
38 Select font used for reminders [default 7x14].
39 -nodate
41 Do not display today's date on the face of the clock.
42 -iconic
44 Start iconified, if supported by the window manager.
45 -adjust ddhhmm
47 Adjust the clock by +/- ddhhmm (dd = days, hh = hours, mm = min‐
48 utes) to fix an incorrect clock without being root or for work‐
49 ing in another time-zone.
50 -update n
52 Update clock face every n seconds [default 30]. If n=1, a sec‐
53 onds hand is displayed.
54 -mail n
56 Check for new mail every n seconds [default 60]. The actual
57 interval is a multiple of the clock update interval.
58 -mailfile mailfile
60 Override environmental variable MAIL with mailfile as location
61 for mail.
62 -mailspawn cmd
64 Execute cmd when the face of the clock is clicked by the mouse
65 button.
66 #geom Specify the preferred icon window size [default 65x65].
68 Some of these options may not be available based on how rclock was com‐
71 piled. Run rclock -help to determine which features are available.
72
75 No X resources are used — only command-line options.
76
79 The window and icon titles are set to the day of the week and the date.
80 The date is also displayed on the lower half of the clock unless the
81 -nodate option is specified. The icon window is "active" and will show
82 the time, if supported by the window manager.
83
86 The ~/.rclock file lists the messages to display and/or the programs to
87 run at specified times and dates. At the specified time, rclock will
88 pop-up a window in the center of the screen to display the message or
89 will simply run the scheduled program. rclock will reads the ~/.rclock
90 file at startup, and every 10 minutes (to look for changes) and after a
91 message window has been dismissed (to find the next appointment).
92 An entry in ~/.rclock may be one of two formats (blank and comment
94 lines will be ignored):
95 hh:mm [dd] MM/DD/YY message[; program]
97 or
98 [hh:mm [dd] MM/DD/YY [message]]; program
99 hh - hour (0-23; * = current)
101 mm - minute (0-59; * = 0)
102 dd - days-of-week (some/all/none of umtwrfs; * = all)
103 MM - month (1-12; * = current)
104 DD - day of month (1-31; * = current)
105 YY - year (0-99 or 1900-????; * = current)
106 message - message to display
107 program - program to execute
108 The days-of-the-week use the following abbreviations: u=Sunday, m=Mon‐
110 day, t=Tuesday, w=Wednesday, r=Thursday, f=Friday, s=Saturday, *=all.
111 If message is empty and program has been specified, it is executed
113 without a dialog box. If time/date are also not specified, program is
114 executed on start-up. Note message may contain escape values (\n: new‐
115 line, \;: semicolon).
116 Here's a silly example file that shows some of the permissible con‐
118 structs:
119 # ~/.rclock - My appointment file
121 # startup functions
123 ; xsetroot -solid Black &
124 # cron functions
126 10:00; xsetroot -solid Grey25 &
128 14:00; xsetroot -solid Grey75 &
129 # daily/weekly reminders
131 08:15 mtwrf * Good Morning!\nRead News?; rxvt -e News
133 12:00 mtwrf * Lunch Time!
134 17:00 mtwrf * Go Home
135 23:00 mtwrf * Still Here? Go to bed
136 08:10 twrf * Did you do your time card yesterday?
137 15:00 f * Friday, do your time card early!
138 16:00 mtwr * Do your time card
139 16:30 mtwrf * Did you do your time card?
140 *:00 us * It's the weekend, why are you here?
141 8:15 f */13/* Friday the 13th! Careful!
142 8:15 * 4/1/* fkrkrmfismsmkd...dkdfk
143 8:16 * 4/1/* April Fools!
144 # birthdays/anniversaries
146 16:00 05/21/* Pam's Birthday (next week)
148 16:00 05/24/* Pam's Birthday (in a few days)
149 # once-of appointments
151 08:30 03/15/94 Dentist appointment
153 08:30 03/15/1999 Dentist appointment
154 08:30 03/15/2004 Dentist appointment
155
159 rclock uses the environment variable MAIL to determine the location of
160 the user's mail spool file unless the -mailfile option is specified.
161
164 rclock is not very smart about dealing with errors encountered while
165 reading the ~/.rclock file. Each reminder must be a single line not
166 exceeding 255 characters. Reminder windows are sometimes not redrawn
167 (left blank) when raised or uncovered.
168
171 Rob Nation <nation@rocket.sanders.lockheed.com>
172 Modifications by mj olesen <olesen@me.QueensU.CA>
174
177 Same as the current rxvt maintainer.
1783rd Berkeley Distribution 26 RCLOCK(1)