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       -H     <name>:s:l:t  Set the hand style, the name can be: hour, minute,
48              second, sub_second, stopwatch or alarm. (s) The style is a  num‐
49              ber  from [0-5] althought not all the syles are defined. (l) The
50              length of the hand from the centre.  (t) The length of the  tail
51              in  the  other  direction to the hand.  0 Quadratic (default), 1
52              Triangle, 2 Rectangle, 3 Pointer, 4 Arrow, 5 Simple line.
53
54       -i     Use the clock icon from the current theme.
55
56       -l     Toggle locking the screen position, stop drag and drop.
57
58       -m     ts Set the marker type and step, default -m13.  (t)  the  marker
59              type,  (s)  The  step  controls  which hours have markers.  0 No
60              markers, 1 Triangles (default), 2 Circles,  3  Latin  digits,  4
61              Roman numerals.
62
63       -n     cnum  or rnum Set the number of columns and rows. Note the maxi‐
64              mum number of clocks is 36 with no more than 10 in a  line.  For
65              example: -nc5 -nr3
66
67       -o     city Specify you own city name for a timezone.
68
69       -q     Quick time setting, no smooth scrolling.
70
71       -s     size Set the size of each clock, the size is rounded to a multi‐
72              ple of 64.
73
74       -S     Enable the stopwatch.
75
76       -w     Put on all work-spaces.
77
78       -x     posn Set the X screen position.
79
80       -y     posn Set the Y screen position. Note, both X and Y must be set.
81
82       -z     zone Select timezone to display. For example: -zLondon
83
84       -24    Show a 24 hour clock.
85
86       -?     Show command line help information.
87

COLOURS

89       In order to change one of the colours you need  to  enter  the  colours
90       code. See details of the -c option.
91
92       cbf    Clock outer border when the face has focus.
93
94       cbn    Clock outer border when the face does not have focus.
95
96       cbi    Clock inner border.
97
98       fce    Main clock face colour.
99
100       fsw    Stopwatch face colour.
101
102       txt    Colour of the text.
103
104       cbf    Clock border when focused.
105
106       cbn    Clock border not focused.
107
108       cbi    Clock border inner circle.
109
110       fce    Clock face colour.
111
112       fsw    Stopwatch dial colour.
113
114       txt    Information text colour.
115
116       hrh    Hour hand outer colour.
117
118       hhf    Hour hand fill colour.
119
120       mnh    Minute hand outer colour.
121
122       mhf    Minute hand fill colour.
123
124       sch    Second hand outer colour.
125
126       shf    Second hand fill colour.
127
128       alh    Alarm hand outer colour.
129
130       ahf    Alarm hand fill colour.
131
132       swh    Stopwatch hand outer colour.
133
134       swf    Stopwatch hand fill colour.
135
136       hrm    Hour marker colour.
137
138       mnm    Minute marker colour.
139
140       swm    Stopwatch marker colour.
141
142       qum    Quarter marker colour.
143
144       qmf    Quarter marker fill colour.
145

DATES

147       In order to change the format of one of the dates you need its code.
148
149       ftl    Clock top in local-time.
150
151       ftz    Clock top for timezone.
152
153       stl    Stopwatch top in local-time.
154
155       stz    Stopwatch top for timezone.
156
157       fbl    Clock bottom in local-time.
158
159       fbz    Clock bottom for timezone.
160
161       sbl    Stopwatch bottom in local-time.
162
163       sbz    Stopwatch bottom for timezone.
164
165       wtl    Window title in local-time.
166
167       wtz    Window title for timezone.
168
169       cbl    Copy date time in local-time.
170
171       cbz    Copy date time for timezone.
172
173       cdl    Copy date in local-time.
174
175       cdz    Copy date for timezone.
176
177       ctl    Copy time in local-time.
178
179       ctz    Copy time for timezone.
180

DATE FORMAT

182       To  specify  a date format you can use the same format as the date com‐
183       mand.  This way your locale information will be used.  In  addition  to
184       the date commands the are a few extra defined for the TzClock.
185
186       %#     Time zone city, upper-cased and wrapped.
187
188       %*     Time zone city.
189
190       %@     Time zone area.
191
192       %&     Stopwatch time: h:mm:ss.hh.
193

EXAMPLE

195       Here  is an example showing the command line for displaying four clocks
196       showing different time zones. With changes to one of  the  colours  and
197       one of the dates.
198
199       TzClock  -l  -nr2 -nc2 -f1 -u -f2 -h -u -z"Moscow" -f3 -h -u -z"London"
200       -f4 -h -u -z"New York" -s128 -ccbn"#000000" -x100  -y200  -dwtl:"%H:%M,
201       %a. %-d %b."
202

AUTHOR

204       Written by Chris Knight.
205

REPORTING BUGS

207       Report bugs to <chris@theknight.co.uk>.
208