--- name: "xclock" section: "1x" platform: "linux" package: "xbase-clients" version: "4.3.0.dfsg.1-14sarge7" release: "Debian 3.1 (Sarge)" platforms: ["linux"] url: "https://new.carta.tech/xclock/1x" --- # xclock(1x) analog / digital clock for X ## NAME xclock - analog / digital clock for X ## SYNOPSIS **xclock** \[ **-help** \] \[ **-analog** \] \[ **-brief** \] \[ **-chime** \] \[ **-digital** \] \[ **-face** *pattern* \] \[ **-hd** *color* \] \[ **-hl** *color* \] \[ **-norender** \] \[ **-padding** *number* \] \[ **-render** \] \[ **-sharp** \] \[ **-strftime** *format* \] \[ **-update** *seconds* \] ## 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. Where available, **xclock** uses the RENDER extension for drawing operations. Using RENDER can cause some configuration options to be ignored, and several RENDER-specific options are available; see below. The RENDER extension is not used if the **-norender** option is specified, if **xclock** was compiled without support for the extension, or if the X server does not support the extension. ## 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. - **-digital** or **-d** This option indicates that a 24-hour digital clock should be used. - **-brief** 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. - **-utime** This option indicates that a digital clock should display seconds since the Epoch (in the format ‘970012340 seconds since Epoch’) instead of a standard 24-hour time. This option is ignored for analog clocks. - **-strftime *format*** This option allows an [**strftime**(3)](/strftime/3.md) 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. - **-hands** *color* (or **-hd** *color*) This option specifies the color of the hands on an analog clock. The default is *black*. *This option is ignored when the RENDER extension is used.* - **-highlight** *color* (or **-hl** *color*) 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 *black*. *This option is ignored when the RENDER extension is used.* - **-update *seconds*** This option specifies the frequency in seconds at which **xclock** 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 *number*** 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 **xclock** to use the RENDER extension to draw an anti-aliased face. This is the default if **xclock** has been compiled with support for the RENDER extension. - **-norender** This option turns off the use of the RENDER extension to draw the clock. - **-sharp** This option tells **xclock** to use sharper edges when drawn using the RENDER extension. - **-face *pattern*** This option specifies the font to use in digital mode when the RENDER 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 (class Width)** Specifies the width of the clock. The default for analog clocks is 164 pixels; the default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font. - **height (class Height)** Specifies the height of the clock. The default for analog clocks is 164 pixels; the default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font. - **update (class Interval)** Specifies the frequency in seconds at which the time should be redisplayed. - **foreground (class Foreground)** Specifies the color for the tick marks. The default depends on whether *reverseVideo* is specified. If *reverseVideo* is specified the default is *white*, otherwise the default is *black*. - **hands (class Foreground)** Specifies the color of the insides of the clock's hands. The default depends on whether *reverseVideo* is specified. If *reverseVideo* is specified the default is *white*, otherwise the default is *black*. *This resource is ignored when the RENDER extension is used.* - **highlight (class Foreground)** Specifies the color used to highlight the clock's hands. The default is depends on whether *reverseVideo* is specified. If *reverseVideo* is specified the default is *white*, otherwise the default is *black*. *This resource is ignored when the RENDER extension is used.* - **analog (class Boolean)** Specifies whether or not an analog clock should be used instead of a digital one. The default is True. - **twentyfour (class Boolean)** Specifies whether or not a digital clock should display the time in twenty-four hour format. The default is True. - **chime (class Boolean)** Specifies whether or not a bell should be rung on the hour and half hour. - **padding (class Margin)** Specifies the amount of internal padding in pixels to be used. The default is 8. - **font (class Font)** Specifies the font to be used for the digital clock. Note that variable width fonts currently will not always display correctly. *This resource is ignored when the RENDER extension is used.* - **render (class Boolean)** Specifies whether or not the RENDER extension should be used for the display. The default is True if **xclock** has been compiled with support for the RENDER extension. When the RENDER extension is used for drawing, the following additional resources are understood: - **face (class FaceName)** Specify the pattern for the font used to draw the digital clock. - **sharp (class Boolean)** Specifies if sharp edges should be used when rendering the clock. The default is False. - **buffer (class Boolean)** Specifies that the updates of the image are drawn to a pixmap before copied into the window instead drawing them into the window directly. The defaults of the following color resources depend on whether *reverseVideo* is specified. If *reverseVideo* is specified the default is *white*, otherwise the default is *black*. - **hourColor (class Foreground)** The color of the hour hand. - **minuteColor (class Foreground)** The color of the minute hand. - **secondColor (class Foreground)** The color of the second hand. - **majorColor (class Foreground)** The color of the major scale ticks (i.e., each five minutes). - **minorColor (class Foreground)** The color of the minor scale ticks (between major ticks). ## WIDGETS In order to specify resources, it is useful to know the hierarchy of the widgets which compose **xclock**. 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 - */etc/X11/app-defaults/XClock* specifies required resources ## SEE ALSO [**X**(7x)](/X/7x.md), [**xrdb**(1x)](/xrdb/1x.md), [**time**(3)](/time/3.md) ## 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)\ Keith Packard (HP)