1TzClock(1) General Commands Manual TzClock(1)
2
6 TzClock - Display the time around the world
7
9 TzClock [OPTION]...
10
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 Options
18 -a Toggle always on top.
19 -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 -b Toggle showing the small second hand.
24 -B Toggle showing the second hand bounce.
26 -c nnn#RRGGBB Change one of the clock colours. Details of the codes
28 can be found below. For example: -cfce#1267FF
29 -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 -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 -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 -F font Select the font to use on the clock face.
44 -h Switch off the second hand.
46 -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 -i Use the clock icon from the current theme.
55 -l Toggle locking the screen position, stop drag and drop.
57 -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 -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 -o city Specify you own city name for a timezone.
68 -q Quick time setting, no smooth scrolling.
70 -s size Set the size of each clock, the size is rounded to a multi‐
72 ple of 64.
73 -S Enable the stopwatch.
75 -w Put on all work-spaces.
77 -x posn Set the X screen position.
79 -y posn Set the Y screen position. Note, both X and Y must be set.
81 -z zone Select timezone to display. For example: -zLondon
83 -24 Show a 24 hour clock.
85 -? Show command line help information.
87
89 In order to change one of the colours you need to enter the colours
90 code. See details of the -c option.
91 cbf Clock outer border when the face has focus.
93 cbn Clock outer border when the face does not have focus.
95 cbi Clock inner border.
97 fce Main clock face colour.
99 fsw Stopwatch face colour.
101 txt Colour of the text.
103 cbf Clock border when focused.
105 cbn Clock border not focused.
107 cbi Clock border inner circle.
109 fce Clock face colour.
111 fsw Stopwatch dial colour.
113 txt Information text colour.
115 hrh Hour hand outer colour.
117 hhf Hour hand fill colour.
119 mnh Minute hand outer colour.
121 mhf Minute hand fill colour.
123 sch Second hand outer colour.
125 shf Second hand fill colour.
127 alh Alarm hand outer colour.
129 ahf Alarm hand fill colour.
131 swh Stopwatch hand outer colour.
133 swf Stopwatch hand fill colour.
135 hrm Hour marker colour.
137 mnm Minute marker colour.
139 swm Stopwatch marker colour.
141 qum Quarter marker colour.
143 qmf Quarter marker fill colour.
145
147 In order to change the format of one of the dates you need its code.
148 ftl Clock top in local-time.
150 ftz Clock top for timezone.
152 stl Stopwatch top in local-time.
154 stz Stopwatch top for timezone.
156 fbl Clock bottom in local-time.
158 fbz Clock bottom for timezone.
160 sbl Stopwatch bottom in local-time.
162 sbz Stopwatch bottom for timezone.
164 wtl Window title in local-time.
166 wtz Window title for timezone.
168 cbl Copy date time in local-time.
170 cbz Copy date time for timezone.
172 cdl Copy date in local-time.
174 cdz Copy date for timezone.
176 ctl Copy time in local-time.
178 ctz Copy time for timezone.
180
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 %# Time zone city, upper-cased and wrapped.
187 %* Time zone city.
189 %@ Time zone area.
191 %& Stopwatch time: h:mm:ss.hh.
193
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 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
204 Written by Chris Knight.
205
207 Report bugs to <chris@theknight.co.uk>.
208
210 date(1)
211 11 Nov 2009 TzClock(1)