Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
RCLOCK(1)			     2003			     RCLOCK(1)

       rclock (ouR CLOCK) -- clock and appointment reminder for	X11

       rclock [options]

       rclock  --  version  2.7.10  -- is an analog clock for X	intended as an
       xclock(1) replacement that conserves memory  and	 has  extra  features:
       rclock  enters  reverse	video if there is mail waiting;	an appointment
       reminder	is also	builtin.

       The options supported by	rclock:

       -display	displayname
	      Attempt to open a	window on the named X display.	In the absence
	      of this option, the display specified by the DISPLAY environment
	      variable is used.

       -geometry geom
	      Create the window	with the specified X window geometry  [default

       -bg color
	      Window background	color [default white].

       -fg color
	      Window foreground	color [default black].

       -fn fontname
	      Select font used for reminders [default 7x14].

	      Do not display today's date on the face of the clock.

	      Start iconified, if supported by the window manager.

       -adjust ddhhmm
	      Adjust the clock by +/- ddhhmm (dd = days, hh = hours, mm	= min-
	      utes) to fix an incorrect	clock without being root or for	 work-
	      ing in another time-zone.

       -update n
	      Update  clock face every n seconds [default 30].	If n=1,	a sec-
	      onds hand	is displayed.

       -mail n
	      Check for	new mail every n seconds [default 60].	The actual in-
	      terval is	a multiple of the clock	update interval.

       -mailfile mailfile
	      Override	environmental  variable	MAIL with mailfile as location
	      for mail.

       -mailspawn cmd
	      Execute cmd when the face	of the clock is	clicked	by  the	 mouse

       #geom  Specify the preferred icon window	size [default 65x65].

       Some of these options may not be	available based	on how rclock was com-
       piled.  Run rclock -help	to determine which features are	available.

       No X resources are used -- only command-line options.

       The window and icon titles are set to the day of	the week and the date.
       The  date  is  also displayed on	the lower half of the clock unless the
       -nodate option is specified.  The icon window is	"active" and will show
       the time, if supported by the window manager.

       The ~/.rclock file lists	the messages to	display	and/or the programs to
       run at specified	times and dates.  At the specified time,  rclock  will
       pop-up  a  window in the	center of the screen to	display	the message or
       will simply run the scheduled program.  rclock will reads the ~/.rclock
       file at startup,	and every 10 minutes (to look for changes) and after a
       message window has been dismissed (to find the next appointment).

       An entry	in ~/.rclock may be one	of  two	 formats  (blank  and  comment
       lines will be ignored):

       hh:mm [dd] MM/DD/YY message[; program]
       [hh:mm [dd] MM/DD/YY [message]];	program

       hh - hour (0-23;	* = current)
       mm - minute (0-59; * = 0)
       dd - days-of-week (some/all/none	of umtwrfs; * =	all)
       MM - month (1-12; * = current)
       DD - day	of month (1-31;	* = current)
       YY - year (0-99 or 1900-????; * = current)
       message - message to display
       program - program to execute

       The  days-of-the-week use the following abbreviations: u=Sunday,	m=Mon-
       day, t=Tuesday, w=Wednesday, r=Thursday,	f=Friday, s=Saturday, *=all.

       If message is empty and program has  been  specified,  it  is  executed
       without	a dialog box.  If time/date are	also not specified, program is
       executed	on start-up.  Note message may contain escape values (\n: new-
       line, \;: semicolon).

       Here's  a  silly	 example  file that shows some of the permissible con-

       # ~/.rclock - My	appointment file

       # startup functions
       ; xsetroot -solid Black &

       # cron functions

       10:00; xsetroot -solid Grey25 &
       14:00; xsetroot -solid Grey75 &

       # daily/weekly reminders

       08:15 mtwrf *	  Good Morning!\nRead News?; rxvt -e News
       12:00 mtwrf *	  Lunch	Time!
       17:00 mtwrf *	  Go Home
       23:00 mtwrf *	  Still	Here? Go to bed
       08:10 twrf  *	  Did you do your time card yesterday?
       15:00 f	   *	  Friday, do your time card early!
       16:00 mtwr  *	  Do your time card
       16:30 mtwrf *	  Did you do your time card?
       *:00  us	   *	  It's the weekend, why	are you	here?
       8:15  f	   */13/* Friday the 13th! Careful!
       8:15  *	   4/1/*  fkrkrmfismsmkd...dkdfk
       8:16  *	   4/1/*  April	Fools!

       # birthdays/anniversaries

       16:00	05/21/*	  Pam's	Birthday (next week)
       16:00	05/24/*	  Pam's	Birthday (in a few days)

       # once-of appointments

       08:30	03/15/94    Dentist appointment
       08:30	03/15/1999  Dentist appointment
       08:30	03/15/2004  Dentist appointment

       rclock uses the environment variable MAIL to determine the location  of
       the user's mail spool file unless the -mailfile option is specified.

       rclock  is  not	very smart about dealing with errors encountered while
       reading the ~/.rclock file.  Each reminder must be a  single  line  not
       exceeding  255  characters.  Reminder windows are sometimes not redrawn
       (left blank) when raised	or uncovered.

       Rob Nation <>

       Modifications by	mj olesen <olesen@me.QueensU.CA>

       Same as the current rxvt	maintainer.

3rd Berkeley Distribution	      26			     RCLOCK(1)


Want to link to this manual page? Use this URL:

home | help