tzclock(1)

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

NAME

6       TzClock - Display the time around the world
7

SYNOPSIS

9       TzClock [OPTION]...
10

DESCRIPTION

12       TzClock  can  display  the time around the world.  It supports multiple
13       faces showing different time zones.  There is also a stopwatch that  is
14       accurate to a tenth of a second.  Plus many other nice features for you
15       to discover.
16
17   Options
18       -a     Toggle always on top.
19
20       -A     hh:mm:msg Set the alarm message to be  shown  at  the  specified
21              time. For example: -A17:30:"Time to go home"
22
23       -b     Toggle showing the small second hand.
24
25       -B     Toggle showing the second hand bounce.
26
27       -c     nnn#RRGGBB Change one of the clock colours. Details of the codes
28              can be found below. For example: -cfce#1267FF
29
30       -C     config.file Specify the configuration file  to  use.  This  file
31              should  be  in  your  home  directory.   The  default  file  is:
32              .tzclockrc
33
34       -d     nnn:format Change one of the date formats.  The  format  is  the
35              same as the date command with some extras.  Details of the codes
36              can be found below. For example: -dftl:"%*"
37
38       -f     face Select the face, for future settings, the  faces  are  num‐
39              bered left to right, top to bottom.  Some settings like timezone
40              only effect one face so it  is  necessary  to  select  the  face
41              first.
42
43       -F     font Select the font to use on the clock face.
44
45       -h     Switch off the second hand.
46
47       -i     Use the clock icon from the current theme.
48
49       -l     Toggle locking the screen position, stop drag and drop.
50
51       -n     cnum  or rnum Set the number of columns and rows. Note the maxi‐
52              mum number of clocks is 36 with no more than 10 in a  line.  For
53              example: -nc5 -nr3
54
55       -o     city Specify you own city name for a timezone.
56
57       -q     Quick time setting, no smooth scrolling.
58
59       -s     size Set the size of each clock, the size is rounded to a multi‐
60              ple of 64.
61
62       -S     Enable the stopwatch.
63
64       -w     Put on all work-spaces.
65
66       -x     posn Set the X screen position.
67
68       -y     posn Set the Y screen position. Note, both X and Y must be set.
69
70       -z     zone Select timezone to display. For example: -zLondon
71
72       -24    Show a 24 hour clock.
73
74       -?     Show command line help information.
75

COLOURS

77       In order to change one of the colours you need  to  enter  the  colours
78       code. See details of the -c option.
79
80       cbf    Clock outer border when the face has focus.
81
82       cbn    Clock outer border when the face does not have focus.
83
84       cbi    Clock inner border.
85
86       fce    Main clock face colour.
87
88       fsw    Stopwatch face colour.
89
90       txt    Colour of the text.
91
92       hrh    Border colour of the hour hand.
93
94       mnh    Border colour of the minute hand.
95
96       sch    Colour of the second hand.
97
98       alh    Colour of the alarm hand.
99
100       ctc    Border colour of the center circle.
101
102       hrm    Colour of the hour markers.
103
104       mnm    Colour of the minute markers.
105
106       qum    Border colour of the quarter markers.
107
108       qmf    Fill colour of the quarter markers.
109
110       hhf    Fill colour of the hour hand.
111
112       mnf    Fill colour of the minute hand.
113
114       ccf    Fill colour of the center circle.
115
116       swh    Colour of the stopwatch second hand.
117
118       swc    Border colour of the stopwatch center circle.
119
120       swf    Fill colour of the stopwatch circle fill.
121
122       swm    Colour of the stopwatch minute markers.
123

DATES

125       In order to change the format of one of the dates you need its code.
126
127       ftl    Clock top in local-time.
128
129       ftz    Clock top for timezone.
130
131       stl    Stopwatch top in local-time.
132
133       stz    Stopwatch top for timezone.
134
135       fbl    Clock bottom in local-time.
136
137       fbz    Clock bottom for timezone.
138
139       sbl    Stopwatch bottom in local-time.
140
141       sbz    Stopwatch bottom for timezone.
142
143       wtl    Window title in local-time.
144
145       wtz    Window title for timezone.
146
147       cbl    Copy date time in local-time.
148
149       cbz    Copy date time for timezone.
150
151       cdl    Copy date in local-time.
152
153       cdz    Copy date for timezone.
154
155       ctl    Copy time in local-time.
156
157       ctz    Copy time for timezone.
158

DATE FORMAT

160       To  specify  a date format you can use the same format as the date com‐
161       mand.  This way your locale information will be used.  In  addition  to
162       the date commands the are a few extra defined for the TzClock.
163
164       %#     Time zone city, upper-cased and wrapped.
165
166       %*     Time zone city.
167
168       %@     Time zone area.
169
170       %&     Stopwatch time: h:mm:ss.hh.
171

EXAMPLE

173       Here  is an example showing the command line for displaying four clocks
174       showing different time zones. With changes to one of  the  colours  and
175       one of the dates.
176
177       TzClock  -l  -nr2 -nc2 -f1 -u -f2 -h -u -z"Moscow" -f3 -h -u -z"London"
178       -f4 -h -u -z"New York" -s128 -ccbn"#000000" -x100  -y200  -dwtl:"%H:%M,
179       %a. %-d %b."
180

AUTHOR

182       Written by Chris Knight.
183

REPORTING BUGS

185       Report bugs to <chris@theknight.co.uk>.
186