xonclock(1)

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-min=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.