1XCLOCK(1)                   General Commands Manual                  XCLOCK(1)
2
3
4

NAME

6       xclock - analog / digital clock for X
7

SYNOPSIS

9       xclock  [  -help  ]  [ -analog | -digital ] [ -brief ] [ -chime ] [ -hd
10       color ] [ -hl color ] [ -update  seconds  ]  [  -strftime  format  ]  [
11       -twelve  |  -twentyfour  | -utime ] [ -padding number ] [ -norender ] [
12       -render ] [ -sharp ] [ -face pattern ]
13

DESCRIPTION

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

OPTIONS

20       Xclock accepts all of the standard X Toolkit command line options along
21       with the additional options listed below:
22
23       -help   This  option  indicates  that  a  brief  summary of the allowed
24               options should be printed on the standard error.
25
26       -analog This option indicates that a conventional 12  hour  clock  face
27               with tick marks and hands should be used.  This is the default.
28
29       -digital or -d
30               This  option  indicates  that a 24 hour digital clock should be
31               used.
32
33       -brief  This option indicates that the digital clock should  only  dis‐
34               play  the hours and minutes fields.  The default is to show the
35               full time and date information.
36
37       -utime  This option indicates that a digital clock should display  sec‐
38               onds since the Epoch (in format '970012340 seconds since Epoch'
39               instead of a standard 24-hour time.
40
41       -strftime format
42               This option allows an strftime(3) format string to be specified
43               for the digital clock's display.
44
45       -twelve This  option  indicates that a digital clock should display the
46               time in twelve hour format.
47
48       -twentyfour
49               This option indicates that a digital clock should  display  the
50               time  in  twenty-four  hour format.  This is the default when a
51               digital clock is used.
52
53       -chime  This option indicates that the clock should chime once  on  the
54               half hour and twice on the hour.
55
56       -hands color (or -hd color)
57               This  option  specifies  the  color  of  the hands on an analog
58               clock.  The default  is  black.   This  option  is  effectively
59               ignored when Xrender is in use.
60
61       -highlight color (or -hl color)
62               This option specifies the color of the edges of the hands on an
63               analog clock, and  is  only  useful  on  color  displays.   The
64               default  is  black.   This  option  is effectively ignored when
65               Xrender is in use.
66
67       -update seconds
68               This option specifies the frequency in seconds at which  xclock
69               should  update  its display.  If the clock is obscured and then
70               exposed, it will be updated immediately.  A value of 30 seconds
71               or  less  will  enable  a  second hand on an analog clock.  The
72               default is 60 seconds.
73
74       -padding number
75               This option specifies  the  width  in  pixels  of  the  padding
76               between  the  window  border  and  clock  text or picture.  The
77               default is 10 on a digital clock and 8 on an analog clock.
78
79       -render This option tells xclock to use the Xrender extension  to  draw
80               an  anti-aliased  face.  This is the default if xclock has been
81               compiled with Xrender support.  Note that the  color  selection
82               options  and  resources  used  when Xrender is in effect differ
83               from the standard options.
84
85       -norender
86               This option turns off the use of Xrender to draw the clock.
87
88       -sharp  This option tells xclock to use sharper edges when drawn  using
89               the Xrender extension.
90
91       -face pattern
92               This  option specifies the font to use in digital mode when the
93               Xrender extension is used.  Patterns are  specified  using  the
94               fontconfig  face  format described in the Font Names section of
95               fonts.conf(5).
96

X DEFAULTS

98       This program uses the Clock widget.  It understands  all  of  the  core
99       resource names and classes as well as:
100
101       width (class Width)
102               Specifies  the  width  of  the  clock.   The default for analog
103               clocks is 164 pixels; the default for digital clocks  is  what‐
104               ever  is  needed to hold the clock when displayed in the chosen
105               font.
106
107       height (class Height)
108               Specifies the height of the  clock.   The  default  for  analog
109               clocks  is  164 pixels; the default for digital clocks is what‐
110               ever is needed to hold the clock when displayed in  the  chosen
111               font.
112
113       update (class Interval)
114               Specifies  the frequency in seconds at which the time should be
115               redisplayed.
116
117       foreground (class Foreground)
118               Specifies the color for the tick marks. The default depends  on
119               whether  reverseVideo  is specified.  If reverseVideo is speci‐
120               fied the default is lwhite, otherwise the default is black.
121
122
123       hands (class Foreground)
124               Specifies the color of the insides of the  clock's  hands.  The
125               default  depends  on  whether  reverseVideo  is  specified.  If
126               reverseVideo is specified the default is lwhite, otherwise  the
127               default  is  black.   Note  that this resource is not used when
128               Xrender is in effect.
129
130       highlight (class Foreground)
131               Specifies the color used to highlight the  clock's  hands.  The
132               default is
133                depends on whether reverseVideo is specified.  If reverseVideo
134               is specified the default is lwhite, otherwise  the  default  is
135               black.   Note that this resource is not used when Xrender is in
136               effect.
137
138       analog (class Boolean)
139               Specifies whether or not an analog clock should be used instead
140               of a digital one.  The default is True.
141
142       twentyfour (class Boolean)
143               Specifies  whether  or  not  a digital clock should display the
144               time in twenty-four hour format.  The default is True.
145
146       chime (class Boolean)
147               Specifies whether or not a bell should be rung on the hour  and
148               half hour.
149
150       padding (class Margin)
151               Specifies  the amount of internal padding in pixels to be used.
152               The default is 8.
153
154       font (class Font)
155               Specifies the font to be used for the digital clock.  Note that
156               variable  width  fonts  currently  will not always display cor‐
157               rectly.  This font is only used when Xrender is not in effect.
158
159       render (class Boolean)
160               Specifies whether or not the Xrender extension should  be  used
161               for  the  display.  The default is True if xclock has been com‐
162               piled with Xrender support.
163
164       When Xrender is in  effect,  the  following  additional  resources  are
165       understood:
166
167       face (class FaceName)
168               Specify  the  pattern  for  the font to be used for the digital
169               clock when Xrender is used.   Patterns are specified using  the
170               fontconfig  face  format described in the Font Names section of
171               fonts.conf(5).
172
173       sharp (class Boolean)
174               Specifies if sharp edges should  be  used  when  rendering  the
175               clock.  The default is False.
176
177       buffer (class Boolean)
178               Specifies  that  the updates of the image are drawn to a pixmap
179               before copied into the window instead  drawing  them  into  the
180               window directly.
181
182       The  defaults of the following color resources depend on whether rever‐
183       seVideo is specified.  If reverseVideo  is  specified  the  default  is
184       lwhite, otherwise the default is black.
185
186       hourColor (class Foreground)
187               The color of the hour hand.
188
189       minuteColor (class Foreground)
190               The color of the minute hand.
191
192       secondColor (class Foreground)
193               The color of the second hand.
194
195       majorColor (class Foreground)
196               The color of the major scale ticks (i. e. each five minutes).
197
198       minorColor (class Foreground)
199               The color of the minor scale ticks (between major ticks).
200

WIDGETS

202       In  order  to  specify resources, it is useful to know the hierarchy of
203       the widgets which compose xclock.  In the notation  below,  indentation
204       indicates  hierarchical  structure.   The  widget  class  name is given
205       first, followed by the widget instance name.
206
207       XClock  xclock
208            Clock  clock
209
210

ENVIRONMENT

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

FILES

219       /usr/share/X11/app-defaults/XClock
220              specifies required resources
221

SEE ALSO

223       X(7), xrdb(1), time(3C), fonts.conf (5).
224

BUGS

226       Xclock believes the system clock.
227
228       When in digital mode, the string should be centered automatically.
229

AUTHORS

231       Tony Della Fera (MIT-Athena, DEC)
232       Dave Mankins (MIT-Athena, BBN)
233       Ed Moy (UC Berkeley)
234
235
236
237
238X Version 11                     xclock 1.0.4                        XCLOCK(1)
Impressum