1CAIRO-CLOCK(1)         some dope-shit-funky time display        CAIRO-CLOCK(1)
2
3
4

NAME

6       cairo-clock - an analog clock drawn with vector-graphics
7

SYNOPSIS

9       cairo-clock  [--x  X] [--y Y] [--width WIDTH] [--height HEIGHT] [--sec‐
10       onds]  [--date]  [--theme   name]   [--ontop]   [--pager]   [--taskbar]
11       [--sticky] [--twelve] [--twentyfour] [--refresh]
12       cairo-clock -h, --help
13       cairo-clock -v, --version
14       cairo-clock -l, --list
15

DESCRIPTION

17       This  manual  page  documents briefly the usage of the cairo-clock pro‐
18       gram.  You can move the clock around with your mouse  by  pressing  and
19       holding the left mouse-button and dragging your mouse around. The clock
20       will follow your movements. To resize the clock you have to  press  and
21       hold  the  middle  mouse-button  down  and  drag your mouse around. The
22       upper-left corner of the clock will follow your movements. Just  click‐
23       ing  the  right mouse-button on the clock will bring up the popup-menu.
24       You find three menu-items. Properties, Info  and  Quit.  Selecting  the
25       Properties  item will bring up a dialog where you can change all avail‐
26       able features of the clock (e.g. size, theme, display of optional  ele‐
27       ments,  pager-  and  taskbar-behaviour). The next menu-item, Info, will
28       bring up an informational dialog stating the name of  program,  current
29       version,  author and license information. The third and last menu-item,
30       Quit, really exits the program if you select it.  Surprised?!  ;-)  You
31       can also hit the ESC-key if you want to exit the program.
32
33       If  you  want to install additional themes for the clock you downloaded
34       from the internet you can best place them in you  home-directory  under
35       ~/.cairo-clock/themes. You proably have to create that directory-struc‐
36       ture the first time you install new themes. A theme  there  goes  in  a
37       directory  like  e.g.   ~/.cairo-clock/theme/new_theme. Once you copied
38       the new themes directory there you will be able to select  it  via  the
39       Properties  dialog in the theme-selection widget after a restart of the
40       program. The theme-directories are only scanned  during  program-start.
41       The newly added 24h-mode for cairo-clock will need you to select any of
42       the supplied 24h-themes. While the clock will run without any  problems
43       if  you  switch  to  24h-mode  and still use a 12h-based theme, you are
44       going to want to select a 24h-based theme in order to make any sense of
45       the displayed hand-positions in 24h-mode.
46

OPTIONS

48       cairo-clock  now  uses  common  GNU-convention for commandline-options.
49       Take note that using  commandline-options  overrules  everything  which
50       maybe stored in your local settings-file. Using the commandline-options
51       will completely ignore any settings you may have stored in  your  local
52       settings-file.  Every option will default to program-internal settings.
53       A summary of options is included below.  There is no Info file on this.
54
55       -x, --xposition X
56              The initial x-position of  the  top-left  window-corner  of  the
57              clock will be X.
58
59       -y, --yposition Y
60              The  initial  y-position  of  the  top-left window-corner of the
61              clock will be Y.
62
63       -w, --width WIDTH
64              Initially open the window of the clock with a width of WIDTH.
65
66       -g, --height HEIGHT
67              Initially open the window of the clock with a height of HEIGHT.
68
69       -s, --seconds
70              Passing this means to render the seconds-hand. If you leave this
71              out no seconds-hand will be drawn.
72
73       -d, --date
74              Passing this means to render the date-display. If you leave this
75              out no date will be drawn.
76
77       -l, --list
78              List all themes installed system-wide and locally for  the  cur‐
79              rent user and exit.
80
81       -t, --theme NAME
82              Use  theme NAME for rendering. Use the any of the names returned
83              by the options -l or --list.
84
85       -o, --ontop
86              Passing this means the clock-window will stay  above  all  other
87              windows.  If  you  leave  this out other windows can overlap the
88              clock-window.
89
90       -p, --pager
91              Passing this means the clock-window will appear in the pager. If
92              you  leave  this  out the pager will ignore the clock-window and
93              not display it.
94
95       -b, --taskbar
96              Passing this means the clock-window will show up in the taskbar.
97              If  you  leave this out the clock-window will not show up in the
98              taskbar.
99
100       -i, --sticky
101              Passing this means to have  the  clock-window  appear  all  your
102              workspaces. If you leave this out the clock will only be visible
103              on the current workspace from where you initially started cairo-
104              clock.
105
106       -e, --twelve
107              Passing  this will force the hour hand to use commonly known 12h
108              per full circle.
109
110       -f, --twentyfour
111              Passing this will cause the hour hand to  spread  24h  across  a
112              full circle.
113
114       -r, --refresh RATE
115              Use  an  animation-refreshrate  of  RATE for rendering. Use this
116              with caution! Possible values are 1..60 Hz.
117
118       -h, --help
119              Print a usage-description and exit.
120
121       -v, --version
122              Print the programs version-number and exit.
123

BUGS

125       If redraws don't happen every second (the  second-hand  is  drawn)  the
126       needed  refresh  after  a window-size change via the preferences-dialog
127       only happens on a minute-interval.
128

AUTHOR

130       cairo-clock is written and maintained by  Mirco  Mueller  <macslow@ban‐
131       gang.de>.
132
133       This manual page was written by Mirco Mueller <macslow@bangang.de>, for
134       the Debian/Ubuntu project (but may be used by others).
135
136
137
1380.3.4                          November 23, 2007                CAIRO-CLOCK(1)
Impressum