xonclock(1) - Linux man page

Name

xonclock - simple X on-screen analog clock

Synopsis

xonclock [OPTIONS]

Description

Shows an analog clock on X screen

Options

--skin=FILE

This option tells xonclock which file to be used as a clock skin. xonclock can handle PNG, JPEG, TIFF, XPM images. By default it loads an internal skin.

--position=POSITION

This option defines the clock placement on X screen. It may be: TOP-LEFT, TOP-CENTER, TOP-RIGHT, MIDDLE-LEFT, MIDDLE-CENTER, MIDDLE-RIGHT, BOTTOM-LEFT, BOTTOM-CENTER, BOTTOM-RIGHT. By default it set to BOTTOM-RIGHT.

--offset-v=OFFSET

This option defines vertical offset of the clock concerning its base placement. Positive offset will shift clock lower, negative - upper. Default: 0.

--offset-h=OFFSET

This option defines horizontal offset of the clock concerning its base placement. Positive offset will shift clock right, negative - left. Default: 0.

--hour-length=LENGTH

This option defines length of the clock hour hand. It ought to be positive. Default: automatic.

--hour-width=WIDTH

This option defines width of the clock hour hand. It ought to be positive. Default: 4.

--minute-length=LENGTH

This option defines length of the clock minute hand. It ought to be positive. Default: automatic.

--minute-width=WIDTH

This option defines width of the clock minute hand. It ought to be positive. Default: 3.

--second-length=LENGTH

This option defines length of the clock second hand. It ought to be positive. Default: automatic.

--second-width=WIDTH

This option defines width of the clock second hand. It ought to be positive. Default: 1.

--color-hour=R/G/B/A

This option defines color of the clock hour hand. R/G/B/A are color components: R - red, G - green, B - blue, A - alpha (opacity). Each of them ought to be in 0...255 range. Default: 255/0/0/255.

--color-minute=R/G/B/A

This option defines color of the clock minute hand. R/G/B/A are color components: R - red, G - green, B - blue, A - alpha (opacity). Each of them ought to be in 0...255 range. Default: 0/255/0/255.

--color-second=R/G/B/A

This option defines color of the clock second hand. R/G/B/A are color components: R - red, G - green, B - blue, A - alpha (opacity). Each of them ought to be in 0...255 range. Default: 0/0/255/255.

--hands-rotation-axis=X/Y

This option defines coordinates of the clock hands rotation axis concerning top left corner of a clock window. Usefull for nonrectangular clock skins. Default: center of the clock skin rectangle.

--overlap=SIZE

This option defines length of the clock hands tails that overlaps thru center of the clock hands rotation axis. Default: 1/5 of the clock second hand length.

--sleep=SECONDS

This option defines startup sleep time. It useful if you start xonclock from your ~/.xinitrc file (see startx script manual page). Doing so you will prevent display connection error (it may ouccur if you start xonclock while your have no display created by X server). Default: 0.

--top

Set the clock to be shown always on top. Your windows manager may ignore this request and the option may not work. Default: no.

-s, --show-seconds

Render the second hand. Default: no.

-d, --show-date

Render the date string. Default: no.

--date-font=FONTNAME

This option defines a date string font. Detailed descrition of the font name format see in fontconfig library manual. Default: fixed-8.

--date-color=R/G/B/A

This option defines color of a date string. R/G/B/A are color components: R - red, G - green, B - blue, A - alpha (opacity). Each of them ought to be in 0...255 range. Default: 0/0/0/255.

--date-position=POSITION

This option defines date string position on the clock. It may be: TOP-LEFT, TOP-CENTER, TOP-RIGHT, MIDDLE-LEFT, MIDDLE-CENTER, MIDDLE-RIGHT, BOTTOM-LEFT, BOTTOM-CENTER, BOTTOM-RIGHT. By default it set to MIDDLE-CENTER.

--date-offset-v=OFFSET

This option defines vertical offset of the date string concerning its base placement. Positive offset will shift it lower, negative - upper. Default: 10.

--date-offset-h=OFFSET

This option defines horizontal offset of the date string concerning its base placement. Positive offset will shift it right, negative - left. Default: 0.

--date-format=FORMAT

This option defines format of the date string. Detailed description of the FORMAT may be found in strftime manual page (type man strftime). Default: %G-%m-%d.

--date-clip-format=FORMAT

This option defines format of the date string to be pasted into X clipboard. Note that program was tested with KDE 3.4.1 (KWrite, KEdit) so on other systems it may doesn't work. No multilanguage support are provided for a while. The date string will be copied into X clipboard on mouse left button click over the clock. Detailed description of the FORMAT may be found in strftime manual page (type man strftime). Default: %G-%m-%d %H:%M:%S.

--movable

Allows to move the clock with a mouse left button. Default: not set.

--use-background

This option tells xonclock to merge clock skin with desktop root window background image allowing to render the skins with alpha channel. It does not work with XPM skins. Default: not set.

--remerge-sleep=MICROSECOND

This option tells xonclock to sleep for MICROSECOND to be sure that any obscured window has been refreshed while retrieving new background. This option is useful if only --use-background is used. Default: 5000.

--no-winredirect

If the program is started under KDE or GNOME (and maybe someone else) the clock may get hidden state. Try to set this flag to prevent a such situation. It may help I hope. Default: not set.

--tz-hour=VAL

This option allows to customize system time-zone settings. The hour value obtained from a system call will be calculated as hour's system value + VAL. The valid range is [-24;24]. Default: 0.

--tz-minute=VAL

This option allows to customize system time-zone settings. The minute value obtained from a system call will be calculated as minute's system value + VAL. The valid range is [-60;60]. Default: 0.

--alpha-threshold=VAL

This option defines alpha threshold value that allows to slightly tune up a clock skin with alpha channel. It is only affected if the option --use-background is not set. Default: 0.

-v, --version

Prints program version and exit.

-h, --help

Display help and exit.

Events

-

You may copy date string into X clipboard with mouse left button single click on xonclock. It works if xonclock has been started with --show-date option only.

-

You may exit from xonclock with mouse right button double click.

-

You may remerge desktop root window background image and clock skin by mouse left button double click (it works if xonclock has been started with --use-background option only).

Author

Written by Cyrill Gorcunov <gclion@mail.ru>. There is ABSOLUTELY NO WARRANTY for this program.

Copyright

It may be freely distributed under the terms of GNU General Public License.