NAME

xclock - analog / digital clock for X

SYNOPSIS

xxcclloocckk [ --hheellpp ] [ --aannaalloogg ] [ --ddiiggiittaall ] [ --bbrriieeff ] [ --cchhiimmee ] [ --hhdd _c_o_l_o_r ] [ --hhll _c_o_l_o_r ] [ --uuppddaattee _s_e_c_o_n_d_s ] [ --ssttrrffttiimmee _f_o_r_m_a_t ] [ --ppaaddddiinngg _n_u_m_b_e_r ] [ --nnoorreennddeerr ] [ --rreennddeerr ] [ --sshhaarrpp ] [ --ffaaccee _p_a_t_t_e_r_n ]

DESCRIPTION

The xclock program displays the time in analog or digital form. The time is continuously updated at a frequency which may be specified by the user.

OPTIONS

Xclock accepts all of the standard X Toolkit command line options along with the additional options listed below:
-help
This option indicates that a brief summary of the allowed options should be printed on the standard error.
-analog
This option indicates that a conventional 12 hour clock face with tick marks and hands should be used. This is the default.
--ddiiggiittaall or --dd
This option indicates that a 24 hour digital clock should be used.
--bbrriieeff
This option indicates that the digital clock should only display the hours and minutes fields. The default is to show the full time and date information.
--uuttiimmee or --dd
This option indicates that a digital clock should display seconds since the Epoch (in format '970012340 seconds since Epoch' instead of a standard 24-hour time.
-strftime _f_o_r_m_a_t
This option allows an strftime(3) format string to be specified for the digital clock's display.
-twelve
This option indicates that a digital clock should display the time in twelve hour format.
-twentyfour
This option indicates that a digital clock should display the time in twenty-four hour format. This is the default when a digital clock is used.
-chime
This option indicates that the clock should chime once on the half hour and twice on the hour.
--hhaannddss _c_o_l_o_r (or --hhdd _c_o_l_o_r)
This option specifies the color of the hands on an analog clock. The default is _b_l_a_c_k. This option is effectively ignored when Xrender is in use.
--hhiigghhlliigghhtt _c_o_l_o_r (or --hhll _c_o_l_o_r)
This option specifies the color of the edges of the hands on an analog clock, and is only useful on color displays. The default is _b_l_a_c_k. This option is effectively ignored when Xrender is in use.
-update _s_e_c_o_n_d_s
This option specifies the frequency in seconds at which _x_c_l_o_c_k should update its display. If the clock is obscured and then exposed, it will be updated immediately. A value of 30 seconds or less will enable a second hand on an analog clock. The default is 60 seconds.
-padding _n_u_m_b_e_r
This option specifies the width in pixels of the padding between the window border and clock text or picture. The default is 10 on a digital clock and 8 on an analog clock.
-render
This option tells _x_c_l_o_c_k to use the Xrender extension to draw an anti-aliased face. This is the default if _x_c_l_o_c_k has been compiled with Xrender support. Note that the color selection options and resources used when Xrender is in effect differ from the standard options.
-norender
This option turns off the use of Xrender to draw the clock.
-sharp
This option tells _x_c_l_o_c_k to use sharper edges when drawn using the Xrender extension.
-face _p_a_t_t_e_r_n
This option specifies the font to use in digital mode when the Xrender extension is used.

X DEFAULTS

This program uses the Clock widget. It understands all of the core resource names and classes as well as:

width (_c_l_a_s_s WWiiddtthh))<> <> SSppeecciiffiieess tthhee wwiiddtthh ooff tthhee cclloocckk.. TThhee ddeeffaauulltt ffoorr aannaalloogg cclloocckkss iiss 116644 ppiixxeellss;; tthhee ddeeffaauulltt ffoorr ddiiggiittaall cclloocckkss iiss wwhhaatteevveerr iiss nneeeeddeedd ttoo hhoolldd tthhee cclloocckk wwhheenn ddiissppllaayyeedd iinn tthhee cchhoosseenn ffoonntt.. <> <>hheeiigghhtt ((_c_l_a_s_s HHeeiigghhtt))<> <> SSppeecciiffiieess tthhee hheeiigghhtt ooff tthhee cclloocckk.. TThhee ddeeffaauulltt ffoorr aannaalloogg cclloocckkss iiss 116644 ppiixxeellss;; tthhee ddeeffaauulltt ffoorr ddiiggiittaall cclloocckkss iiss wwhhaatteevveerr iiss nneeeeddeedd ttoo hhoolldd tthhee cclloocckk wwhheenn ddiissppllaayyeedd iinn tthhee cchhoosseenn ffoonntt.. <> <>uuppddaattee ((_c_l_a_s_s IInntteerrvvaall))<> <> SSppeecciiffiieess tthhee ffrreeqquueennccyy iinn sseeccoonnddss aatt wwhhiicchh tthhee ttiimmee sshhoouulldd bbee rreeddiissppllaayyeedd.. <> <>ffoorreeggrroouunndd ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> SSppeecciiffiieess tthhee ccoolloorr ffoorr tthhee ttiicckk mmaarrkkss.. TThhee ddeeffaauulltt ddeeppeennddss oonn wwhheetthheerr _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd.. IIff _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd tthhee ddeeffaauulltt iiss _l_w_h_i_t_e,, ootthheerrwwiissee tthhee ddeeffaauulltt iiss _b_l_a_c_k.. <> <> <>hhaannddss ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> SSppeecciiffiieess tthhee ccoolloorr ooff tthhee iinnssiiddeess ooff tthhee cclloocckk''ss hhaannddss.. TThhee ddeeffaauulltt ddeeppeennddss oonn wwhheetthheerr _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd.. IIff _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd tthhee ddeeffaauulltt iiss _l_w_h_i_t_e,, ootthheerrwwiissee tthhee ddeeffaauulltt iiss _b_l_a_c_k.. NNoottee tthhaatt tthhiiss rreessoouurrccee iiss nnoott uusseedd wwhheenn XXrreennddeerr iiss iinn eeffffeecctt.. <> <>hhiigghhlliigghhtt ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> SSppeecciiffiieess tthhee ccoolloorr uusseedd ttoo hhiigghhlliigghhtt tthhee cclloocckk''ss hhaannddss.. TThhee ddeeffaauulltt iiss ddeeppeennddss oonn wwhheetthheerr _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd.. IIff _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd tthhee ddeeffaauulltt iiss _l_w_h_i_t_e,, ootthheerrwwiissee tthhee ddeeffaauulltt iiss _b_l_a_c_k.. NNoottee tthhaatt tthhiiss rreessoouurrccee iiss nnoott uusseedd wwhheenn XXrreennddeerr iiss iinn eeffffeecctt.. <> <>aannaalloogg ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott aann aannaalloogg cclloocckk sshhoouulldd bbee uusseedd iinnsstteeaadd ooff aa ddiiggiittaall oonnee.. TThhee ddeeffaauulltt iiss TTrruuee.. <> <>ttwweennttyyffoouurr ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott aa ddiiggiittaall cclloocckk sshhoouulldd ddiissppllaayy tthhee ttiimmee iinn ttwweennttyy--ffoouurr hhoouurr ffoorrmmaatt.. TThhee ddeeffaauulltt iiss TTrruuee.. <> <>cchhiimmee ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott aa bbeellll sshhoouulldd bbee rruunngg oonn tthhee hhoouurr aanndd hhaallff hhoouurr.. <> <>ppaaddddiinngg ((_c_l_a_s_s MMaarrggiinn))<> <> SSppeecciiffiieess tthhee aammoouunntt ooff iinntteerrnnaall ppaaddddiinngg iinn ppiixxeellss ttoo bbee uusseedd.. TThhee ddeeffaauulltt iiss 88.. <> <>ffoonntt ((_c_l_a_s_s FFoonntt))<> <> SSppeecciiffiieess tthhee ffoonntt ttoo bbee uusseedd ffoorr tthhee ddiiggiittaall cclloocckk.. NNoottee tthhaatt vvaarriiaabbllee wwiiddtthh ffoonnttss ccuurrrreennttllyy wwiillll nnoott aallwwaayyss ddiissppllaayy ccoorrrreeccttllyy.. TThhiiss ffoonntt iiss oonnllyy uusseedd wwhheenn XXrreennddeerr iiss nnoott iinn eeffffeecctt.. <> <>rreennddeerr ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess wwhheetthheerr oorr nnoott tthhee XXrreennddeerr eexxtteennssiioonn sshhoouulldd bbee uusseedd ffoorr tthhee ddiissppllaayy.. TThhee ddeeffaauulltt iiss TTrruuee iiff _x_c_l_o_c_k hhaass bbeeeenn ccoommppiilleedd wwiitthh XXrreennddeerr ssuuppppoorrtt.. <> <> WWhheenn XXrreennddeerr iiss iinn eeffffeecctt,, tthhee ffoolllloowwiinngg aaddddiittiioonnaall rreessoouurrcceess aarree uunnddeerrssttoooodd:: <> <> <> <>ffaaccee ((_c_l_a_s_s FFaacceeNNaammee))<> <> SSppeecciiffyy tthhee ppaatttteerrnn ffoorr tthhee ffoonntt ttoo bbee uusseedd ffoorr tthhee ddiiggiittaall cclloocckk wwhheenn XXrreennddeerr iiss uusseedd.. <> <>sshhaarrpp ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess iiff sshhaarrpp eeddggeess sshhoouulldd bbee uusseedd wwhheenn rreennddeerriinngg tthhee cclloocckk.. TThhee ddeeffaauulltt iiss FFaallssee.. <> <>bbuuffffeerr ((_c_l_a_s_s BBoooolleeaann))<> <> SSppeecciiffiieess tthhaatt tthhee uuppddaatteess ooff tthhee iimmaaggee aarree ddrraawwnn ttoo aa ppiixxmmaapp bbeeffoorree ccooppiieedd iinnttoo tthhee wwiinnddooww iinnsstteeaadd ddrraawwiinngg tthheemm iinnttoo tthhee wwiinnddooww ddiirreeccttllyy.. <> <> TThhee ddeeffaauullttss ooff tthhee ffoolllloowwiinngg ccoolloorr rreessoouurrcceess ddeeppeenndd oonn wwhheetthheerr _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd.. IIff _r_e_v_e_r_s_e_V_i_d_e_o iiss ssppeecciiffiieedd tthhee ddeeffaauulltt iiss _l_w_h_i_t_e,, ootthheerrwwiissee tthhee ddeeffaauulltt iiss _b_l_a_c_k.. <> <> <>hhoouurrCCoolloorr ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> TThhee ccoolloorr ooff tthhee hhoouurr hhaanndd.. <> <>mmiinnuutteeCCoolloorr ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> TThhee ccoolloorr ooff tthhee mmiinnuuttee hhaanndd.. <> <>sseeccoonnddCCoolloorr ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> TThhee ccoolloorr ooff tthhee sseeccoonndd hhaanndd.. <> <>mmaajjoorrCCoolloorr ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> TThhee ccoolloorr ooff tthhee mmaajjoorr ssccaallee ttiicckkss ((ii.. ee.. eeaacchh ffiivvee mmiinnuutteess)).. <> <>mmiinnoorrCCoolloorr ((_c_l_a_s_s FFoorreeggrroouunndd))<> <> TThhee ccoolloorr ooff tthhee mmiinnoorr ssccaallee ttiicckkss ((bbeettwweeeenn mmaajjoorr ttiicckkss)).. <> <> WWIIDDGGEETTSS <> IInn oorrddeerr ttoo ssppeecciiffyy rreessoouurrcceess,, iitt iiss uusseeffuull ttoo kknnooww tthhee hhiieerraarrcchhyy ooff tthhee wwiiddggeettss wwhhiicchh ccoommppoossee _x_c_l_o_c_k. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.


XClock  xclock
     Clock  clock


ENVIRONMENT

DISPLAY
to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

FILES

/usr/X11R6/lib/X11/app-defaults/XClock
specifies required resources

SEE ALSO

X(7), xrdb(1), time(3C)

BUGS

Xclock believes the system clock.

When in digital mode, the string should be centered automatically.

AUTHORS

Tony Della Fera (MIT-Athena, DEC)
Dave Mankins (MIT-Athena, BBN)
Ed Moy (UC Berkeley)